Get User Timeline by Page

Fetch a single page from a user’s timeline using POST. Pass next_cursor in the body to continue.

Back to API Reference

/Timeline Endpoints

TwexAPI REST

POST/twitter/{screen_name}/timeline/page

Authorization

AuthorizationBearer token · headerrequired

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

Path Parameters

screen_namestringrequired

Twitter screen name of the target user (with or without @).

Request Body

requiredapplication/json

next_cursorstring | any

Cursor returned by the previous page. Leave empty to fetch the first page.

Show properties

Any of:

string

string

any

any

countinteger

Maximum number of tweets to return for this page.

min 1 · max 100 · default: 20

Responses

200Current page data and pagination metadata (has_next_page, next_cursor).

codeinteger

HTTP status code

default: 200

msgstring

Response message

default: "success"

dataUserTweetItem[]required

Current page tweet items.

Show properties

Array of UserTweetItem

tweet_idstringrequired

Tweet ID

is_paid_promotionboolean

Whether the tweet is associated with a paid promotion

default: false

full_textstring | any

Tweet text

Show properties

Any of:

string

string

any

any

created_atstring | any

Tweet creation time

Show properties

Any of:

string

string

any

any

langstring | any

Tweet language

Show properties

Any of:

string

string

any

any

conversation_idstring | any

Conversation ID

Show properties

Any of:

string

string

any

any

bookmark_countinteger

Bookmark count

default: 0

favorite_countinteger

Like count

default: 0

reply_countinteger

Reply count

default: 0

retweet_countinteger

Retweet count

default: 0

quote_countinteger

Quote count

default: 0

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

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 display name

Show properties

Any of:

string

string

any

any

author_is_blue_verifiedboolean | any

Blue verification flag

Show properties

Any of:

boolean

boolean

any

any

author_verifiedboolean | any

Legacy verification flag

Show properties

Any of:

boolean

boolean

any

any

author_is_verified_organization_affiliateboolean | any

Verified organization affiliate flag

Show properties

Any of:

boolean

boolean

any

any

has_next_pagebooleanrequired

Whether another page is available.

next_cursorstring | any

Use this cursor to fetch the next page when has_next_page is true.

Show properties

Any of:

string

string

any

any

requested_countintegerrequired

Original count requested by the client.

effective_countintegerrequired

Count after credit throttling was applied.

parsed_countintegerrequired

Number of tweets actually parsed from the response.

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/twitter/{screen_name}/timeline/page

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.

⚙️Parameters (1)

screen_namepath

RequiredTwitter screen name of the target user (with or without @).

📝Request Bodyapplication/json

next_cursorstring

OptionalCursor returned by the previous page. Leave empty to fetch the first page.

countinteger

OptionalMaximum number of tweets to return for this page.

💡 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/twitter/Ian_Codes/timeline/page" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "next_cursor": "",
  "count": 20
}'

const response = await fetch("https://api.twexapi.io/twitter/Ian_Codes/timeline/page", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "next_cursor": "",
  "count": 20
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/Ian_Codes/timeline/page",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "next_cursor": "",
  "count": 20
},
)

Response

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "tweet_id": "string",
      "is_paid_promotion": false,
      "full_text": "string",
      "created_at": "string",
      "lang": "string",
      "conversation_id": "string",
      "bookmark_count": 0,
      "favorite_count": 0,
      "reply_count": 0,
      "retweet_count": 0,
      "quote_count": 0,
      "view_count": "string",
      "view_count_state": "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
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAAHCgABHFeD5h9__-cLAAIAAAATMjAzODIzMzA5NTM4ODY4MDU5NAgAAwAAAAIAAA",
  "requested_count": 0,
  "effective_count": 0,
  "parsed_count": 0
}

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