List Twitter Articles API

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/list

This 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
`ct0`	string	No	Optional current CSRF token cookie. When provided with `twid`, skips server-side credential resolution.
`twid`	string	No	Optional current user ID cookie, for example `u=1234567890`. Must be provided with `ct0`.
`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

Notes

If you already have current ct0 and twid, send both to skip the extra server-side credential bootstrap from auth_token. If either one is omitted, the server resolves them from auth_token as before. Stale or invalid supplied values are not validated upfront and may fail on the actual Twitter action instead of returning an early 401.

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
  }'

List Articles

Request Body

Notes

Response (200)

Examples

Paginate

On this page