> ## 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 Fetch X Articles

> Retrieves detailed article content for a specified list of X (Twitter) IDs. Use this endpoint to fetch full text, metadata, and media links for multiple posts in a single request. 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 /x/article
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:
  /x/article:
    post:
      tags:
        - Article Endpoints
      summary: Batch Fetch X Articles
      description: >-
        Retrieves detailed article content for a specified list of X (Twitter)
        IDs. Use this endpoint to fetch full text, metadata, and media links for
        multiple posts in a single request. 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: x_article_api_x_article_post
      requestBody:
        content:
          application/json:
            schema:
              items:
                type: string
              type: array
              title: Tweet Ids
              description: A list of tweet IDs to get the articles for.
              examples:
                - '1803006263529541838'
                - '1803006263529541839'
        required: true
      responses:
        '200':
          description: >-
            A list of objects containing detailed article data for each valid ID
            provided.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/XArticleResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    XArticleResponse:
      properties:
        code:
          type: integer
          title: Code
          description: The status code of the response.
        msg:
          type: string
          title: Msg
          description: The message of the response.
        data:
          items:
            $ref: '#/components/schemas/XArticleModel'
          type: array
          title: Data
          description: A list of X article objects.
      type: object
      required:
        - code
        - msg
        - data
      title: XArticleResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    XArticleModel:
      properties:
        tweet_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Tweet Id
          description: The ID of the tweet
        full_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Full Text
          description: The full text of the article tweet
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
          description: The creation time
        lang:
          anyOf:
            - type: string
            - type: 'null'
          title: Lang
          description: The language
        bookmark_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Bookmark Count
          description: Bookmark count
        favorite_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Favorite Count
          description: Favorite count
        reply_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Reply Count
          description: Reply count
        retweet_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Retweet Count
          description: Retweet count
        quote_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Quote Count
          description: Quote count
        view_count:
          anyOf:
            - type: string
            - type: 'null'
          title: View Count
          description: View count
        view_count_state:
          anyOf:
            - type: string
            - type: 'null'
          title: View Count State
          description: View count state
        conversation_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Conversation Id
          description: Conversation ID
        author_user_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Author User Id
          description: Author user ID
        author_screen_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Author Screen Name
          description: Author screen name
        author_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Author Name
          description: Author name
        author_is_blue_verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Author Is Blue Verified
          description: Whether author is blue verified
        author_verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Author Verified
          description: Whether author is verified
        author_is_verified_organization_affiliate:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Author Is Verified Organization Affiliate
          description: Whether author is verified organization
        article_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Article Id
          description: Article ID
        article_title:
          anyOf:
            - type: string
            - type: 'null'
          title: Article Title
          description: Article title
        article_preview_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Article Preview Text
          description: Article preview text
        article_summary_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Article Summary Text
          description: Article summary text
        article_cover_image_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Article Cover Image Url
          description: Article cover image URL
        article_blocks:
          items:
            $ref: '#/components/schemas/ArticleBlock'
          type: array
          title: Article Blocks
          description: Article formatting blocks
        article_plain_text:
          anyOf:
            - type: string
            - type: 'null'
          title: Article Plain Text
          description: Article plain text
        article_markdown:
          anyOf:
            - type: string
            - type: 'null'
          title: Article Markdown
          description: Article markdown
        article_media_image_urls:
          items:
            type: string
          type: array
          title: Article Media Image Urls
          description: Article media image URLs
      type: object
      title: XArticleModel
    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
    ArticleBlock:
      properties:
        type:
          type: string
          title: Type
          description: The type of the article block.
        text:
          type: string
          title: Text
          description: The text of the article block.
        entityRanges:
          items:
            $ref: '#/components/schemas/ArticleBlockRange'
          type: array
          title: Entityranges
          description: The entity ranges of the article block.
      type: object
      required:
        - type
        - text
      title: ArticleBlock
    ArticleBlockRange:
      properties:
        key:
          type: integer
          title: Key
          description: The key of the entity range.
        length:
          type: integer
          title: Length
          description: The length of the entity range.
        offset:
          type: integer
          title: Offset
          description: The offset of the entity range.
      type: object
      required:
        - key
        - length
        - offset
      title: ArticleBlockRange
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````