Articles
List Articles
Paginated list of the auth_token user's own Twitter/X articles, filtered by draft or published lifecycle. $0.005 per call.
POST
/twitter/article/listThis endpoint costs $0.005 per API call.
Paginated list of the auth_token user's own articles.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
auth_token | string | Yes | User's auth token |
lifecycle | string | No | "Draft" (default) or "Published" |
cursor | string | No | Pagination cursor from a previous response |
count | number | No | Page size, default 20 |
proxy | string | No | Your proxy URL |
Response (200)
{
"userId": "1454465540949307394",
"lifecycle": "Draft",
"article_count": 5,
"has_more": true,
"next_cursor": "...",
"articles": [
{
"article_id": "2055861112222986240",
"title": "Renamed (still safe to delete)",
"preview_text": "",
"lifecycle": "Draft",
"cover_media": null,
"tweet_id": null,
"created_at_secs": 1778990421,
"modified_at_secs": 1778990510
}
]
}Examples
curl -X POST "https://api.getxapi.com/twitter/article/list" \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-d '{
"auth_token": "your_auth_token",
"lifecycle": "Published"
}'Paginate
curl -X POST "https://api.getxapi.com/twitter/article/list" \
-H "Authorization: Bearer API_KEY" \
-H "Content-Type: application/json" \
-d '{
"auth_token": "your_auth_token",
"lifecycle": "Draft",
"cursor": "NEXT_CURSOR_FROM_PREV_RESPONSE",
"count": 50
}'Update ArticleNew
Partial-update an existing Twitter/X article — title, body markdown, or cover image. $0.005 per call. Works on drafts and published articles.
Publish ArticleNew
Publish an existing draft Twitter/X article to the timeline. $0.005 per call. Premium-only — the auth_token account must have X Premium.