> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twexapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch Get Tweets by ID

> Retrieve detailed information for multiple Tweets by their IDs. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS.



## OpenAPI

````yaml /api-reference/openapi.json post /twitter/tweets/lookup
openapi: 3.1.0
info:
  title: Twitter API Service
  description: |2-

            A comprehensive Twitter API service that provides various Twitter operations including:
            
            * **Search Operations**: Advanced search, hashtags, cashtags
            * **Tweet Operations**: Post, like, retweet, quote, bookmark, delete
            * **User Operations**: Batch user information retrieval
            * **Influencer Operations**: Get tweets from top influencers
            
            All endpoints return standardized responses in the format:
            ```json
            {
                "code": 200,
                "msg": "success", 
                "data": {...}
            }
            ```
            
            ## Authentication
            
            This API uses Bearer token authentication. Include your token in the Authorization header:
            ```
            Authorization: Bearer your_token_here
            ```
            
  contact:
    name: API Support
    email: support@twitterxapi.com
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.twexapi.io
    description: Development server
security: []
paths:
  /twitter/tweets/lookup:
    post:
      tags:
        - Tweets Endpoints
      summary: Batch Get Tweets by ID
      description: >-
        Retrieve detailed information for multiple Tweets by their IDs. The
        maximum input quantity is limited by your plan's QPS. To pass larger
        input quantity limits, upgrade your plan to get higher QPS.
      operationId: get_tweets_by_ids_twitter_tweets_lookup_post
      requestBody:
        content:
          application/json:
            schema:
              items:
                type: string
              type: array
              title: Tweet Ids
              description: >-
                A list of Twitter tweet IDs. Provide multiple times for multiple
                tweets (e.g., `[1803006263529541838,1803006263529541839]`).
              examples:
                - '1803006263529541838'
                - '1803006263529541839'
        required: true
      responses:
        '200':
          description: A list of Tweet objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTweetsByIdResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    GetTweetsByIdResponse:
      properties:
        code:
          type: integer
          title: Code
          description: HTTP status code
          default: 200
        msg:
          type: string
          title: Msg
          description: Response message
          default: success
        data:
          anyOf:
            - items:
                $ref: '#/components/schemas/TweetModel'
              type: array
            - type: 'null'
          title: Data
          description: Tweet data
      type: object
      title: GetTweetsByIdResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    TweetModel:
      properties:
        tweet_id:
          type: string
          title: Tweet Id
          description: The unique identifier for the Tweet
          example: '1803006263529541838'
        is_paid_promotion:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Paid Promotion
          description: >-
            Indicates whether the content or user is associated with a paid
            promotion
          default: false
          example: true
        text:
          type: string
          title: Text
          description: The actual text content of the Tweet
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
          description: The date and time the Tweet was created
          example: Mon Jun 17 03:51:48 +0000 2024
        created_at_datetime:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At Datetime
          description: The ISO 8601 format of the creation date
          example: '2024-06-17T03:51:48.000Z'
        bookmark_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Bookmark Count
          description: Number of times the Tweet has been bookmarked
          default: 0
        bookmarked:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Bookmarked
          description: Indicates if the authenticating user has bookmarked this Tweet
          default: false
        community_note:
          anyOf:
            - type: string
            - type: 'null'
          title: Community Note
          description: Community note associated with the Tweet
        edit_tweet_ids:
          items:
            type: string
          type: array
          title: Edit Tweet Ids
          description: A list of Tweet IDs for each edit of the Tweet
          default: []
        editable_until_msecs:
          anyOf:
            - type: string
            - type: 'null'
          title: Editable Until Msecs
          description: Timestamp for when the Tweet is no longer editable
        edits_remaining:
          anyOf:
            - type: string
            - type: 'null'
          title: Edits Remaining
          description: Number of edits remaining for the Tweet
        favorite_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Favorite Count
          description: Number of likes (favorites) for the Tweet
          default: 0
        favorited:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Favorited
          description: Indicates if the authenticating user has liked this Tweet
          default: false
        full_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Full Text
          description: The full text of the Tweet, especially for extended tweets
        has_card:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Card
          description: Indicates if the Tweet has a card attached
          default: false
        has_community_notes:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Community Notes
          description: Indicates if the Tweet has community notes
          default: false
        hashtags:
          items:
            type: string
          type: array
          title: Hashtags
          description: A list of hashtags mentioned in the Tweet
          default: []
          example:
            - AI
            - Python
        cashtags:
          items:
            type: string
          type: array
          title: Cashtags
          description: A list of cashtags (stock symbols) mentioned in the Tweet
          default: []
          example:
            - $TSLA
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
          description: The unique identifier for the Tweet (same as tweet_id)
        in_reply_to:
          anyOf:
            - type: string
            - type: 'null'
          title: In Reply To
          description: ID of the Tweet this is a reply to
        in_reply_to_user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: In Reply To User Id
          description: ID of the user this is a reply to
        in_reply_to_screen_name:
          anyOf:
            - type: string
            - type: 'null'
          title: In Reply To Screen Name
          description: Screen name of the user this is a reply to
        is_edit_eligible:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Edit Eligible
          description: Indicates if the Tweet is eligible for editing
          default: false
        is_quote_status:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Quote Status
          description: Indicates if this Tweet is a quote of another Tweet
          default: false
        quoted_status_id_str:
          anyOf:
            - type: string
            - type: 'null'
          title: Quoted Status Id Str
          description: The unique identifier for the Tweet that this is a quote of
        is_translatable:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Translatable
          description: Indicates if the Tweet is translatable
          default: false
        lang:
          anyOf:
            - type: string
            - type: 'null'
          title: Lang
          description: The BCP 47 language identifier for the Tweet's content
          example: en
        media:
          items:
            $ref: '#/components/schemas/MediaModel'
          type: array
          title: Media
          description: A list of media objects (photos, videos) attached to the Tweet
          default: []
        place:
          anyOf:
            - type: string
            - type: 'null'
          title: Place
          description: The location associated with the Tweet
        poll:
          anyOf:
            - type: string
            - type: 'null'
          title: Poll
          description: A poll attached to the Tweet
        possibly_sensitive:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Possibly Sensitive
          description: Indicates if the Tweet may contain sensitive content
        possibly_sensitive_editable:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Possibly Sensitive Editable
          description: Indicates if the sensitive content flag is editable
        quote:
          anyOf:
            - $ref: '#/components/schemas/TweetModel'
            - type: 'null'
          description: The Tweet object being quoted
        quote_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Quote Count
          description: Number of times this Tweet has been quoted
          default: 0
        related_tweets:
          items:
            $ref: '#/components/schemas/TweetModel'
          type: array
          title: Related Tweets
          description: A list of related Tweets
          default: []
        replies:
          items:
            $ref: '#/components/schemas/TweetModel'
          type: array
          title: Replies
          description: A list of replies to this Tweet
          default: []
        reply_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Reply Count
          description: Number of replies to this Tweet
          default: 0
        reply_to:
          anyOf:
            - $ref: '#/components/schemas/TweetModel'
            - type: 'null'
          description: The Tweet object this is a reply to
        retweet_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Retweet Count
          description: Number of times this Tweet has been retweeted
          default: 0
        retweeted_tweet:
          anyOf:
            - $ref: '#/components/schemas/TweetModel'
            - type: 'null'
          description: The original Tweet object if this is a retweet
        thread:
          anyOf:
            - items:
                $ref: '#/components/schemas/TweetModel'
              type: array
            - type: 'null'
          title: Thread
          description: The conversation thread ID
        thumbnail_title:
          anyOf:
            - type: string
            - type: 'null'
          title: Thumbnail Title
          description: Title for the thumbnail in a card
        thumbnail_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Thumbnail Url
          description: URL for the thumbnail in a card
        urls:
          items:
            type: string
          type: array
          title: Urls
          description: A list of URLs included in the Tweet
          default: []
        user:
          anyOf:
            - $ref: '#/components/schemas/UserModel'
            - type: 'null'
          description: The user who posted the Tweet
        view_count:
          anyOf:
            - type: string
            - type: 'null'
          title: View Count
          description: Number of views for the Tweet
        view_count_state:
          anyOf:
            - type: string
            - type: 'null'
          title: View Count State
          description: State of the view count
        status:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Status
          description: Raw status dictionary
        target_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Target Count
          description: The target count of items requested, for context
      type: object
      required:
        - tweet_id
        - text
      title: TweetModel
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    MediaModel:
      properties:
        id:
          type: string
          title: Id
          description: Media ID
          example: '1802991873836883968'
        type:
          type: string
          title: Type
          description: Type of media (e.g., photo, video)
          example: photo
        display_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Display Url
          description: URL of the media to display
          example: pic.twitter.com/...
        expanded_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Expanded Url
          description: Expanded URL for the media
        media_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Media Url
          description: Direct URL to the media file
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
          description: t.co URL for the media
        height:
          anyOf:
            - type: integer
            - type: 'null'
          title: Height
          description: Height of the media in pixels
          example: 1080
        width:
          anyOf:
            - type: integer
            - type: 'null'
          title: Width
          description: Width of the media in pixels
          example: 1920
        features:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Features
          description: Features of the media
        original_info:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Original Info
          description: Original information about the media
        sizes:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Sizes
          description: Available sizes of the media
        source_status_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Status Id
          description: Source tweet ID if the media is a retweet
        source_user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Source User Id
          description: Source user ID if the media is a retweet
        duration_millis:
          anyOf:
            - type: integer
            - type: 'null'
          title: Duration Millis
          description: Duration of the video in milliseconds
        aspect_ratio:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
          title: Aspect Ratio
          description: Aspect ratio of the video
          example:
            - 16
            - 9
        video_info:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Video Info
          description: Detailed video information
        streams:
          items:
            $ref: '#/components/schemas/StreamModel'
          type: array
          title: Streams
          description: List of available video streams
          default: []
      type: object
      required:
        - id
        - type
      title: MediaModel
    UserModel:
      properties:
        id:
          type: string
          title: Id
          description: User ID
          example: '1717001045992251392'
        name:
          type: string
          title: Name
          description: Display name
          example: Cryptoklepto
        screen_name:
          type: string
          title: Screen Name
          description: Twitter username
          example: CK_Cryptoklepto
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
          description: Account creation date
          example: Mon Oct 28 02:32:47 +0000 2024
        created_at_datetime:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At Datetime
          description: Account creation datetime in ISO format
          example: '2024-10-28T02:32:47.000Z'
        can_dm:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Can Dm
          description: Whether the user can be direct messaged
          default: false
        can_media_tag:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Can Media Tag
          description: Whether the user can be tagged in media
          default: false
        default_profile:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Default Profile
          description: Whether the user has a default profile
          default: false
        default_profile_image:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Default Profile Image
          description: Whether the user has a default profile image
          default: false
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: User's bio description
          default: ''
        description_urls:
          items:
            type: string
          type: array
          title: Description Urls
          description: List of URLs found in the user's description
          default: []
        urls:
          anyOf:
            - items:
                $ref: '#/components/schemas/urlModel'
              type: array
            - type: 'null'
          title: Urls
          description: List of URLs found in the user's profile
        fast_followers_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Fast Followers Count
          description: Count of fast followers
          default: 0
        favourites_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Favourites Count
          description: Number of tweets the user has liked
          default: 0
        followers_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Followers Count
          description: Number of followers
          default: 0
        following_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Following Count
          description: Number of users this user is following
          default: 0
        has_custom_timelines:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Custom Timelines
          description: Whether the user has custom timelines
          default: false
        is_blue_verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Blue Verified
          description: Blue verification status
          default: false
        verified_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Verified Type
          description: >-
            Verification badge type when not blue-only: blue, business,
            government, etc.
          examples:
            - government
            - business
            - blue
        is_verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Verified
          description: >-
            True if the account has any verification badge (blue, business,
            government, or legacy verified)
          default: false
        profile_image_shape:
          anyOf:
            - type: string
            - type: 'null'
          title: Profile Image Shape
          description: >-
            Profile image shape (Circle or Square; Square often indicates
            business/government)
          examples:
            - Circle
            - Square
        is_translator:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is Translator
          description: Whether the user is a translator
          default: false
        listed_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Listed Count
          description: Number of public lists the user is a member of
          default: 0
        location:
          anyOf:
            - type: string
            - type: 'null'
          title: Location
          description: User's location
          default: ''
          example: New York, USA
        media_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Media Count
          description: Number of media tweets posted by the user
          default: 0
        normal_followers_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Normal Followers Count
          description: Count of normal followers
          default: 0
        pinned_tweet_ids:
          items:
            type: string
          type: array
          title: Pinned Tweet Ids
          description: List of pinned tweet IDs
          default: []
        possibly_sensitive:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Possibly Sensitive
          description: Whether the user's profile may contain sensitive content
          default: false
        profile_banner_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Profile Banner Url
          description: URL of the user's profile banner
        profile_image_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Profile Image Url
          description: URL of the user's profile image
        protected:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Protected
          description: Whether the user's tweets are protected
          default: false
        statuses_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Statuses Count
          description: Number of tweets posted by the user
          default: 0
      type: object
      required:
        - id
        - name
        - screen_name
      title: UserModel
    StreamModel:
      properties:
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
          description: URL of the video stream
          example: https://video.twimg.com/...
        bitrate:
          anyOf:
            - type: integer
            - type: 'null'
          title: Bitrate
          description: Bitrate of the video stream in bps
          example: 832000
        content_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Content Type
          description: Content type of the stream
          example: video/mp4
      type: object
      title: StreamModel
    urlModel:
      properties:
        url:
          type: string
          title: Url
          description: URL
          example: https://www.google.com
        expanded_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Expanded Url
          description: Expanded URL
          example: https://www.google.com
        display_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Display Url
          description: Display URL
          example: www.google.com
      type: object
      required:
        - url
      title: urlModel
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````