---
title: "Batch Fetch X Articles"
method: POST
path: "/x/article"
tags: ["Article Endpoints"]
---

# Batch Fetch X Articles

`POST /x/article`

## Request

- Base URL: `https://api.twexapi.io`
- URL: `https://api.twexapi.io/x/article`
- Auth: HTTP bearer

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.

## Request body

- string[]: A list of tweet IDs to get the articles for.

## Response `200`

A list of objects containing detailed article data for each valid ID provided.

- XArticleResponse
  - `code` integer, required: The status code of the response.
  - `msg` string, required: The message of the response.
  - `data` XArticleModel[], required: A list of X article objects.
    - `tweet_id` string, nullable: The ID of the tweet
    - `full_text` string, nullable: The full text of the article tweet
    - `created_at` string, nullable: The creation time
    - `lang` string, nullable: The language
    - `bookmark_count` integer, nullable: Bookmark count
    - `favorite_count` integer, nullable: Favorite count
    - `reply_count` integer, nullable: Reply count
    - `retweet_count` integer, nullable: Retweet count
    - `quote_count` integer, nullable: Quote count
    - `view_count` string, nullable: View count
    - `view_count_state` string, nullable: View count state
    - `conversation_id` string, nullable: Conversation ID
    - `author_user_id` string, nullable: Author user ID
    - `author_screen_name` string, nullable: Author screen name
    - `author_name` string, nullable: Author name
    - `author_is_blue_verified` boolean, nullable: Whether author is blue verified
    - `author_verified` boolean, nullable: Whether author is verified
    - `author_is_verified_organization_affiliate` boolean, nullable: Whether author is verified organization
    - `article_id` string, nullable: Article ID
    - `article_title` string, nullable: Article title
    - `article_preview_text` string, nullable: Article preview text
    - `article_summary_text` string, nullable: Article summary text
    - `article_cover_image_url` string, nullable: Article cover image URL
    - `article_blocks` ArticleBlock[]: Article formatting blocks
      - `type` string, required: The type of the article block.
      - `text` string, required: The text of the article block.
      - `entityRanges` ArticleBlockRange[]: The entity ranges of the article block.
        - `key` integer, required: The key of the entity range.
        - `length` integer, required: The length of the entity range.
        - `offset` integer, required: The offset of the entity range.
    - `article_plain_text` string, nullable: Article plain text
    - `article_markdown` string, nullable: Article markdown
    - `article_media_image_urls` string[]: Article media image URLs

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/twexapi/apis/twexapi-rest-api.md) · [All operations](https://skmtc.dev/twexapi/apis/twexapi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twexapi/apis/twexapi-rest-api/revisions/59a99ac0d8f7?raw)
