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.

Back to API Reference

/Article Endpoints

TwexAPI REST

POST/x/article

Authorization

AuthorizationBearer token · headerrequired

Global API Bearer Token for TwexAPI. Included as: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Request Body

requiredapplication/json

Array of string

string

Responses

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

codeintegerrequired

The status code of the response.

msgstringrequired

The message of the response.

dataXArticleModel[]required

A list of X article objects.

Show properties

Array of XArticleModel

tweet_idstring | any

The ID of the tweet

Show properties

Any of:

string

string

any

any

full_textstring | any

The full text of the article tweet

Show properties

Any of:

string

string

any

any

created_atstring | any

The creation time

Show properties

Any of:

string

string

any

any

langstring | any

The language

Show properties

Any of:

string

string

any

any

bookmark_countinteger | any

Bookmark count

Show properties

Any of:

integer

integer

any

any

favorite_countinteger | any

Favorite count

Show properties

Any of:

integer

integer

any

any

reply_countinteger | any

Reply count

Show properties

Any of:

integer

integer

any

any

retweet_countinteger | any

Retweet count

Show properties

Any of:

integer

integer

any

any

quote_countinteger | any

Quote count

Show properties

Any of:

integer

integer

any

any

view_countstring | any

View count

Show properties

Any of:

string

string

any

any

view_count_statestring | any

View count state

Show properties

Any of:

string

string

any

any

conversation_idstring | any

Conversation ID

Show properties

Any of:

string

string

any

any

author_user_idstring | any

Author user ID

Show properties

Any of:

string

string

any

any

author_screen_namestring | any

Author screen name

Show properties

Any of:

string

string

any

any

author_namestring | any

Author name

Show properties

Any of:

string

string

any

any

author_is_blue_verifiedboolean | any

Whether author is blue verified

Show properties

Any of:

boolean

boolean

any

any

author_verifiedboolean | any

Whether author is verified

Show properties

Any of:

boolean

boolean

any

any

author_is_verified_organization_affiliateboolean | any

Whether author is verified organization

Show properties

Any of:

boolean

boolean

any

any

article_idstring | any

Article ID

Show properties

Any of:

string

string

any

any

article_titlestring | any

Article title

Show properties

Any of:

string

string

any

any

article_preview_textstring | any

Article preview text

Show properties

Any of:

string

string

any

any

article_summary_textstring | any

Article summary text

Show properties

Any of:

string

string

any

any

article_cover_image_urlstring | any

Article cover image URL

Show properties

Any of:

string

string

any

any

article_blocksArticleBlock[]

Article formatting blocks

Show properties

Array of ArticleBlock

typestringrequired

The type of the article block.

textstringrequired

The text of the article block.

entityRangesArticleBlockRange[]

The entity ranges of the article block.

Show properties

Array of ArticleBlockRange

keyintegerrequired

The key of the entity range.

lengthintegerrequired

The length of the entity range.

offsetintegerrequired

The offset of the entity range.

article_plain_textstring | any

Article plain text

Show properties

Any of:

string

string

any

any

article_markdownstring | any

Article markdown

Show properties

Any of:

string

string

any

any

article_media_image_urlsstring[]

Article media image URLs

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

⚡Interactive Console / Try APIPOST/x/article

Live Console

🌐Target Server:https://api.twexapi.io

● Production Ready

🔍

Public Data Read (TwexAPI Key Only, No Twitter Cookie Required)

This endpoint queries public Twitter data — no Twitter account or Cookie required! Simply enter your TwexAPI Platform Key (Bearer Token) in the "API Authorization" section below to test.

🔑API Authorization

Remember keySync to code samples

TwexAPI Platform Key Bearer TokenRequired

Global API key used across all TwexAPI endpoints. Get it from the console.

📝Request Bodyapplication/json

💡 Quick send:⌘ / Ctrl+Enter

📡

No Response Yet

Configure parameters in the Request tab and click Send Request below.

Request

curl -X POST "https://api.twexapi.io/x/article" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
  "1803006263529541838",
  "1803006263529541839"
]'

const response = await fetch("https://api.twexapi.io/x/article", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify([
  "1803006263529541838",
  "1803006263529541839"
])
});

import requests

response = requests.post(
    "https://api.twexapi.io/x/article",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json=[
  "1803006263529541838",
  "1803006263529541839"
],
)

Response

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "tweet_id": "string",
      "full_text": "string",
      "created_at": "string",
      "lang": "string",
      "bookmark_count": 0,
      "favorite_count": 0,
      "reply_count": 0,
      "retweet_count": 0,
      "quote_count": 0,
      "view_count": "string",
      "view_count_state": "string",
      "conversation_id": "string",
      "author_user_id": "string",
      "author_screen_name": "string",
      "author_name": "string",
      "author_is_blue_verified": true,
      "author_verified": true,
      "author_is_verified_organization_affiliate": true,
      "article_id": "string",
      "article_title": "string",
      "article_preview_text": "string",
      "article_summary_text": "string",
      "article_cover_image_url": "string",
      "article_blocks": [
        {
          "type": "string",
          "text": "string",
          "entityRanges": [
            {
              "key": 0,
              "length": 0,
              "offset": 0
            }
          ]
        }
      ],
      "article_plain_text": "string",
      "article_markdown": "string",
      "article_media_image_urls": [
        "string"
      ]
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}