X (Twitter) Community Notes API

The Community Notes API from X (Twitter) — 5 operation(s) for community notes.

Operations 5

POST /2/evaluate_note X Evaluate a Community Note #
POST /2/notes X Create a Community Note #
GET /2/notes/search/notes_written X Search for Community Notes Written #
GET /2/notes/search/posts_eligible_for_notes X Search for Posts Eligible for Community Notes #
DELETE /2/notes/{id} X Delete a Community Note #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/twitter-community-notes-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twitter-community-notes-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: X API v2 available endpoints
  version: '2.161'
  title: X API v2 Account Activity Community Notes API
  termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html
  contact:
    name: X Developers
    url: https://developer.x.com/
  license:
    name: X Developer Agreement and Policy
    url: https://developer.x.com/en/developer-terms/agreement-and-policy.html
servers:
- description: X API
  url: https://api.x.com
tags:
- name: Community Notes
paths:
  /2/evaluate_note:
    post:
      security:
      - OAuth2UserToken:
        - tweet.write
      - UserToken: []
      tags:
      - Community Notes
      summary: X Evaluate a Community Note
      description: Endpoint to evaluate a community note.
      externalDocs:
        url: https://communitynotes.x.com/guide/api/overview
      operationId: evaluateCommunityNotes
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EvaluateNoteRequest'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvaluateNoteResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/notes:
    post:
      security:
      - OAuth2UserToken:
        - tweet.write
      - UserToken: []
      tags:
      - Community Notes
      summary: X Create a Community Note
      description: Creates a community note endpoint for LLM use case.
      externalDocs:
        url: https://communitynotes.x.com/guide/api/overview
      operationId: createCommunityNotes
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateNoteRequest'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateNoteResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/notes/search/notes_written:
    get:
      security:
      - OAuth2UserToken:
        - tweet.read
      - UserToken: []
      tags:
      - Community Notes
      summary: X Search for Community Notes Written
      description: Returns all the community notes written by the user.
      externalDocs:
        url: https://docs.x.com/x-api/community-notes/search-for-community-notes-written
      operationId: searchCommunityNotesWritten
      parameters:
      - name: test_mode
        in: query
        description: If true, return the notes the caller wrote for the test. If false, return the notes the caller wrote on the product.
        required: true
        schema:
          type: boolean
        style: form
        example: true
      - name: pagination_token
        in: query
        description: Pagination token to get next set of posts eligible for notes.
        required: false
        schema:
          type: string
        style: form
        example: next_token_abc123
      - name: max_results
        in: query
        description: Max results to return.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          format: int32
          default: 10
        style: form
        example: 10
      - $ref: '#/components/parameters/NoteFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2NotesSearchNotesWrittenResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/notes/search/posts_eligible_for_notes:
    get:
      security:
      - OAuth2UserToken:
        - tweet.read
      - UserToken: []
      tags:
      - Community Notes
      summary: X Search for Posts Eligible for Community Notes
      description: Returns all the posts that are eligible for community notes.
      externalDocs:
        url: https://docs.x.com/x-api/community-notes/search-for-posts-eligible-for-community-notes
      operationId: searchEligiblePosts
      parameters:
      - name: test_mode
        in: query
        description: If true, return a list of posts that are for the test. If false, return a list of posts that the bots can write proposed notes on the product.
        required: true
        schema:
          type: boolean
        style: form
        example: true
      - name: pagination_token
        in: query
        description: Pagination token to get next set of posts eligible for notes.
        required: false
        schema:
          type: string
        style: form
        example: next_token_abc123
      - name: max_results
        in: query
        description: Max results to return.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          format: int32
          default: 10
        style: form
        example: 10
      - name: post_selection
        in: query
        description: 'The selection of posts to return. Valid values are ''feed_size: [small|large|xl|xxl], feed_lang: [en|es|...|all]''. Default (if not specified) is ''feed_size: small, feed_lang: en''. Only top AI writers have access to large, xl, and xxl size feeds.'
        required: false
        schema:
          type: string
        style: form
        example: example_value
      - $ref: '#/components/parameters/TweetFieldsParameter'
      - $ref: '#/components/parameters/TweetExpansionsParameter'
      - $ref: '#/components/parameters/MediaFieldsParameter'
      - $ref: '#/components/parameters/PollFieldsParameter'
      - $ref: '#/components/parameters/UserFieldsParameter'
      - $ref: '#/components/parameters/PlaceFieldsParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2NotesSearchPostsEligibleForNotesResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /2/notes/{id}:
    delete:
      security:
      - OAuth2UserToken:
        - tweet.write
      - UserToken: []
      tags:
      - Community Notes
      summary: X Delete a Community Note
      description: Deletes a community note.
      externalDocs:
        url: https://communitynotes.x.com/guide/api/overview
      operationId: deleteCommunityNotes
      parameters:
      - name: id
        in: path
        description: The community note id to delete.
        required: true
        schema:
          $ref: '#/components/schemas/NoteId'
        style: simple
        example: '1234567890'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteNoteResponse'
        default:
          description: The request has failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  parameters:
    NoteFieldsParameter:
      name: note.fields
      in: query
      description: A comma separated list of Note fields to display.
      required: false
      schema:
        type: array
        description: The fields available for a Note object.
        minItems: 1
        uniqueItems: true
        items:
          type: string
          enum:
          - id
          - info
          - scoring_status
          - status
          - test_result
        example:
        - id
        - info
        - scoring_status
        - status
        - test_result
      explode: false
      style: form
    MediaFieldsParameter:
      name: media.fields
      in: query
      description: A comma separated list of Media fields to display.
      required: false
      schema:
        type: array
        description: The fields available for a Media object.
        minItems: 1
        uniqueItems: true
        items:
          type: string
          enum:
          - alt_text
          - duration_ms
          - height
          - media_key
          - non_public_metrics
          - organic_metrics
          - preview_image_url
          - promoted_metrics
          - public_metrics
          - type
          - url
          - variants
          - width
        example:
        - alt_text
        - duration_ms
        - height
        - media_key
        - non_public_metrics
        - organic_metrics
        - preview_image_url
        - promoted_metrics
        - public_metrics
        - type
        - url
        - variants
        - width
      explode: false
      style: form
    PlaceFieldsParameter:
      name: place.fields
      in: query
      description: A comma separated list of Place fields to display.
      required: false
      schema:
        type: array
        description: The fields available for a Place object.
        minItems: 1
        uniqueItems: true
        items:
          type: string
          enum:
          - contained_within
          - country
          - country_code
          - full_name
          - geo
          - id
          - name
          - place_type
        example:
        - contained_within
        - country
        - country_code
        - full_name
        - geo
        - id
        - name
        - place_type
      explode: false
      style: form
    TweetExpansionsParameter:
      name: expansions
      in: query
      description: A comma separated list of fields to expand.
      schema:
        type: array
        description: The list of fields you can expand for a [Tweet](#Tweet) object. If the field has an ID, it can be expanded into a full object.
        minItems: 1
        uniqueItems: true
        items:
          type: string
          enum:
          - article.cover_media
          - article.media_entities
          - attachments.media_keys
          - attachments.media_source_tweet
          - attachments.poll_ids
          - author_id
          - edit_history_tweet_ids
          - entities.mentions.username
          - geo.place_id
          - in_reply_to_user_id
          - entities.note.mentions.username
          - referenced_tweets.id
          - referenced_tweets.id.attachments.media_keys
          - referenced_tweets.id.author_id
        example:
        - article.cover_media
        - article.media_entities
        - attachments.media_keys
        - attachments.media_source_tweet
        - attachments.poll_ids
        - author_id
        - edit_history_tweet_ids
        - entities.mentions.username
        - geo.place_id
        - in_reply_to_user_id
        - entities.note.mentions.username
        - referenced_tweets.id
        - referenced_tweets.id.attachments.media_keys
        - referenced_tweets.id.author_id
      explode: false
      style: form
    TweetFieldsParameter:
      name: tweet.fields
      in: query
      description: A comma separated list of Tweet fields to display.
      required: false
      schema:
        type: array
        description: The fields available for a Tweet object.
        minItems: 1
        uniqueItems: true
        items:
          type: string
          enum:
          - article
          - attachments
          - author_id
          - card_uri
          - community_id
          - context_annotations
          - conversation_id
          - created_at
          - display_text_range
          - edit_controls
          - edit_history_tweet_ids
          - entities
          - geo
          - id
          - in_reply_to_user_id
          - lang
          - media_metadata
          - non_public_metrics
          - note_tweet
          - organic_metrics
          - possibly_sensitive
          - promoted_metrics
          - public_metrics
          - referenced_tweets
          - reply_settings
          - scopes
          - source
          - suggested_source_links
          - suggested_source_links_with_counts
          - text
          - withheld
        example:
        - article
        - attachments
        - author_id
        - card_uri
        - community_id
        - context_annotations
        - conversation_id
        - created_at
        - display_text_range
        - edit_controls
        - edit_history_tweet_ids
        - entities
        - geo
        - id
        - in_reply_to_user_id
        - lang
        - media_metadata
        - non_public_metrics
        - note_tweet
        - organic_metrics
        - possibly_sensitive
        - promoted_metrics
        - public_metrics
        - referenced_tweets
        - reply_settings
        - scopes
        - source
        - suggested_source_links
        - suggested_source_links_with_counts
        - text
        - withheld
      explode: false
      style: form
    PollFieldsParameter:
      name: poll.fields
      in: query
      description: A comma separated list of Poll fields to display.
      required: false
      schema:
        type: array
        description: The fields available for a Poll object.
        minItems: 1
        uniqueItems: true
        items:
          type: string
          enum:
          - duration_minutes
          - end_datetime
          - id
          - options
          - voting_status
        example:
        - duration_minutes
        - end_datetime
        - id
        - options
        - voting_status
      explode: false
      style: form
    UserFieldsParameter:
      name: user.fields
      in: query
      description: A comma separated list of User fields to display.
      required: false
      schema:
        type: array
        description: The fields available for a User object.
        minItems: 1
        uniqueItems: true
        items:
          type: string
          enum:
          - affiliation
          - confirmed_email
          - connection_status
          - created_at
          - description
          - entities
          - id
          - is_identity_verified
          - location
          - most_recent_tweet_id
          - name
          - parody
          - pinned_tweet_id
          - profile_banner_url
          - profile_image_url
          - protected
          - public_metrics
          - receives_your_dm
          - subscription
          - subscription_type
          - url
          - username
          - verified
          - verified_followers_count
          - verified_type
          - withheld
        example:
        - affiliation
        - confirmed_email
        - connection_status
        - created_at
        - description
        - entities
        - id
        - is_identity_verified
        - location
        - most_recent_tweet_id
        - name
        - parody
        - pinned_tweet_id
        - profile_banner_url
        - profile_image_url
        - protected
        - public_metrics
        - receives_your_dm
        - subscription
        - subscription_type
        - url
        - username
        - verified
        - verified_followers_count
        - verified_type
        - withheld
      explode: false
      style: form
  schemas:
    UrlImage:
      type: object
      description: Represent the information for the URL image.
      properties:
        height:
          $ref: '#/components/schemas/MediaHeight'
        url:
          $ref: '#/components/schemas/Url'
        width:
          $ref: '#/components/schemas/MediaWidth'
    CreateNoteRequest:
      type: object
      title: Note
      required:
      - test_mode
      - post_id
      - info
      properties:
        info:
          $ref: '#/components/schemas/NoteInfo'
        post_id:
          $ref: '#/components/schemas/TweetId'
        test_mode:
          type: boolean
          description: If true, the note being submitted is only for testing the capability of the bot, and won't be publicly visible. If false, the note being submitted will be a new proposed note on the product.
      additionalProperties: false
    NextToken:
      type: string
      description: The next token.
      minLength: 1
    Topic:
      type: object
      description: The topic of a Space, as selected by its creator.
      required:
      - id
      - name
      properties:
        description:
          type: string
          description: The description of the given topic.
          example: All about technology
        id:
          $ref: '#/components/schemas/TopicId'
        name:
          type: string
          description: The name of the given topic.
          example: Technology
    CashtagFields:
      type: object
      description: Represent the portion of text recognized as a Cashtag, and its start and end position within the text.
      required:
      - tag
      properties:
        tag:
          type: string
          example: TWTR
    CountryCode:
      type: string
      description: A two-letter ISO 3166-1 alpha-2 country code.
      pattern: ^[A-Z]{2}$
      example: US
    NoteRatingStatus:
      type: string
      description: Community Note rating status
      enum:
      - currently_rated_helpful
      - currently_rated_not_helpful
      - firm_reject
      - insufficient_consensus
      - minimum_ratings_not_met
      - needs_more_ratings
      - needs_your_help
    Get2NotesSearchPostsEligibleForNotesResponse:
      type: object
      properties:
        data:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/Tweet'
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/Problem'
        includes:
          $ref: '#/components/schemas/Expansions'
        meta:
          type: object
          properties:
            next_token:
              $ref: '#/components/schemas/NextToken'
            result_count:
              $ref: '#/components/schemas/ResultCount'
    NoteTestResult:
      type: object
      description: The evaluation result of a community note.
      properties:
        evaluator_score_bucket:
          type: string
          description: Score bucket from the evaluator result.
        evaluator_type:
          type: string
          description: The type of the evaluator.
    NoteFactorBucketCounts:
      type: object
      description: Rating counts for a rater factor bucket.
      properties:
        helpful_count:
          type: integer
          description: The count of helpful ratings.
        helpful_tag_counts:
          type: object
          description: Helpful tag counts.
          properties:
            tag_count:
              type: integer
              description: The count of the tag.
            tag_name:
              type: string
              description: The name of the tag.
        not_helpful_count:
          type: integer
          description: The count of not helpful ratings.
        not_helpful_tag_counts:
          type: object
          description: Not helpful tag counts.
          properties:
            tag_count:
              type: integer
              description: The count of the tag.
            tag_name:
              type: string
              description: The name of the tag.
        somewhat_helpful_count:
          type: integer
          description: The count of somewhat helpful ratings.
    UrlEntity:
      description: Represent the portion of text recognized as a URL, and its start and end position within the text.
      allOf:
      - $ref: '#/components/schemas/EntityIndicesInclusiveExclusive'
      - $ref: '#/components/schemas/UrlFields'
    NoteTweetText:
      type: string
      description: The note content of the Tweet.
      example: Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i
    ReplySettingsWithVerifiedUsers:
      type: string
      description: Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, subscribers, verified and following.
      pattern: ^[A-Za-z]{1,12}$
      enum:
      - everyone
      - mentionedUsers
      - following
      - other
      - subscribers
      - verified
    TweetWithheld:
      type: object
      description: Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).
      required:
      - copyright
      - country_codes
      properties:
        copyright:
          type: boolean
          description: Indicates if the content is being withheld for on the basis of copyright infringement.
        country_codes:
          type: array
          description: Provides a list of countries where this content is not available.
          minItems: 1
          uniqueItems: true
          items:
            $ref: '#/components/schemas/CountryCode'
        scope:
          type: string
          description: Indicates whether the content being withheld is the `tweet` or a `user`.
          enum:
          - tweet
          - user
    FullTextEntities:
      type: object
      properties:
        annotations:
          type: array
          minItems: 1
          items:
            description: Annotation for entities based on the Tweet text.
            allOf:
            - $ref: '#/components/schemas/EntityIndicesInclusiveInclusive'
            - type: object
              description: Represents the data for the annotation.
              properties:
                normalized_text:
                  type: string
                  description: Text used to determine annotation.
                  example: Barack Obama
                probability:
                  type: number
                  description: Confidence factor for annotation type.
                  minimum: 0
                  maximum: 1
                  format: double
                type:
                  type: string
                  description: Annotation type.
                  example: Person
        cashtags:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/CashtagEntity'
        hashtags:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/HashtagEntity'
        mentions:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/MentionEntity'
        urls:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/UrlEntity'
    ContextAnnotationDomainFields:
      type: object
      description: Represents the data for the context annotation domain.
      required:
      - id
      properties:
        description:
          type: string
          description: Description of the context annotation domain.
          example: Example description for this resource.
        id:
          type: string
          description: The unique id for a context annotation domain.
          pattern: ^[0-9]{1,19}$
          example: '1234567890'
        name:
          type: string
          description: Name of the context annotation domain.
          example: Example User
    HttpStatusCode:
      type: integer
      description: HTTP Status Code.
      minimum: 100
      maximum: 599
    EvaluateNoteResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            claim_opinion_score:
              type: number
              description: Claim opinion model score for the note.
              format: double
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/Problem'
    TweetId:
      type: string
      description: Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
      pattern: ^[0-9]{1,19}$
      example: '1346889436626259968'
    Position:
      type: array
      description: A [GeoJson Position](https://tools.ietf.org/html/rfc7946#section-3.1.1) in the format `[longitude,latitude]`.
      minItems: 2
      maxItems: 2
      items:
        type: number
      example:
      - -105.18816086351444
      - 40.247749999999996
    EvaluateNoteRequest:
      type: object
      required:
      - post_id
      - note_text
      properties:
        note_text:
          type: string
          description: Text for the community note.
        post_id:
          $ref: '#/components/schemas/TweetId'
      additionalProperties: false
    NoteScoringStatus:
      type: object
      description: The scoring status of a Community Note.
      properties:
        has_access:
          type: boolean
          description: Whether the user has access to the scoring status of the Community Note.
        rating_counts_per_model:
          type: object
          description: Rating count stats per model.
          properties:
            model_name:
              type: string
              description: The name of the model.
            value:
              $ref: '#/components/schemas/NoteRatingCountsPerModel'
    MisleadingTags:
      type: string
      description: Community Note misleading tags type.
      enum:
      - disputed_claim_as_fact
      - factual_error
      - manipulated_media
      - misinterpreted_satire
      - missing_important_context
      - other
      - outdated_information
    NoteInfo:
      type: object
      description: A X Community Note is a note on a Post.
      required:
      - text
      - classification
      - misleading_tags
      - trustworthy_sources
      properties:
        classification:
          $ref: '#/components/schemas/NoteClassification'
        misleading_tags:
          type: array
          items:
            $ref: '#/components/schemas/MisleadingTags'
        text:
          type: string
          description: The text summary in the Community Note.
          pattern: ^(?=[\s\S]*https?://\S+)[\s\S]+$
        trustworthy_sources:
          type: boolean
          description: Whether the note provided trustworthy links.
      additionalProperties: false
    TweetText:
      type: string
      description: The content of the Tweet.
      example: Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\u2026 https:\/\/t.co\/56a0vZUx7i
    PlaceId:
      type: string
      description: The identifier for this place.
      example: f7eb2fa2fea288b1
    Poll:
      type: object
      description: Represent a Poll attached to a Tweet.
      required:
      - id
      - options
      properties:
        duration_minutes:
          type: integer
          minimum: 5
          maximum: 10080
          format: int32
        end_datetime:
          type: string
          format: date-time
        id:
          $ref: '#/components/schemas/PollId'
        options:
          type: array
          minItems: 2
          maxItems: 4
          items:
            $ref: '#/components/schemas/PollOption'
        voting_status:
          type: string
          enum:
          - open
          - closed
    Note:
      type: object
      description: A X Community Note is a note on a Post.
      required:
      - id
      - post_id
      - note_info
      properties:
        id:
          $ref: '#/components/schemas/NoteId'
        info:
          $ref: '#/components/schemas/NoteInfo'
        post_id:
          $ref: '#/components/schemas/TweetId'
        scoring_status:
          $ref: '#/components/schemas/NoteScoringStatus'
        status:
          $ref: '#/components/schemas/NoteRatingStatus'
        test_result:
          $ref: '#/components/schemas/NoteTestResult'
    UserId:
      type: string
      description: Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
      pattern: ^[0-9]{1,19}$
      example: '2244994945'
    UrlFields:
      type: object
      description: Represent the portion of text recognized as a URL.
      required:
      - url
      properties:
        description:
          type: string
          description: Description of the URL landing page.
          example: This is a description of the website.
        display_url:
          type: string
          description: The URL as displayed in the X client.
          example: twittercommunity.com/t/introducing-…
        expanded_url:
          $ref: '#/components/schemas/Url'
        images:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/UrlImage'
        media_key:
          $ref: '#/components/schemas/MediaKey'
        status:
          $ref: '#/components/schemas/HttpStatusCode'
        title:
          type: string
          description: Title of the page the URL points to.
          example: Introducing the v2 follow lookup endpoints
        unwound_url:
          type: string
          description: Fully resolved url.
          format: uri
          example: https://twittercommunity.com/t/introducing-the-v2-follow-lookup-endpoints/147118
        url:
          $ref: '#/components/schemas/Url'
    Geo:
      type: object
      required:
      - type
      - bbox
      - properties
      properties:
        bbox:
          type: array
          minItems: 4
          maxItems: 4
          items:
            type: number
            minimum: -180
            maximum: 180
            format: double
          example:
          - -105.193475
          - 39.60973
          - -105.053164
          - 39.761974
        geometry:
          $ref: '#/components/schemas/Point'
        properties:
          type: object
        type:
          type: string
          enum:
          - Feature
    UserName:
      type: string
      description: The X handle (screen name) of this user.
      pattern: ^[A-Za-z0-9_]{1,15}$
    MediaHeight:
      type: integer
      description: The height of the media in pixels.
      minimum: 0
    ContextAnnotationEntityFields:
      type: object
      description: Represents the data for the context annotation entity.
      required:
      - id
      properties:
        description:
          type: string
          description: Description of the context annotation entity.
          example: Example description for this resource.
        id:
          type: string
          description: The unique id for a context annotation entity.
          pattern: ^[0-9]{1,19}$
          example: '1234567890'
        name:
          type: string
          description: Name of the context annotation entity.
          example: Example User
    DeleteNoteResponse:
      type: object
      properties:
        data:
          type: object
          required:
          - deleted
          properties:
            deleted:
              type: boolean
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/Problem'
    ResultCount:
      type: integer
      description: The number of results returned in this response.
      format: int32
    Expansions:
      type: object
      properti

# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/openapi/twitter-community-notes-api-openapi.yml