---
title: "Get User Timeline by Page"
method: POST
path: "/twitter/{screen_name}/timeline/page"
tags: ["Timeline Endpoints"]
---

# Get User Timeline by Page

`POST /twitter/{screen_name}/timeline/page`

## Request

- Base URL: `https://api.twexapi.io`
- URL: `https://api.twexapi.io/twitter/{screen_name}/timeline/page`
- Auth: HTTP bearer

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

## Path parameters

- `screen_name` string, required: Twitter screen name of the target user (with or without @).

## Request body

- UserTimelinePageQuery
  - `next_cursor` string, nullable: Cursor returned by the previous page. Leave empty to fetch the first page.
  - `count` integer: Maximum number of tweets to return for this page.

## Response `200`

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

- UserTimelinePageResponse
  - `code` integer: HTTP status code
  - `msg` string: Response message
  - `data` UserTweetItem[], required: Current page tweet items.
    - `tweet_id` string, required: Tweet ID
    - `is_paid_promotion` boolean: Whether the tweet is associated with a paid promotion
    - `full_text` string, nullable: Tweet text
    - `created_at` string, nullable: Tweet creation time
    - `lang` string, nullable: Tweet language
    - `conversation_id` string, nullable: Conversation ID
    - `bookmark_count` integer: Bookmark count
    - `favorite_count` integer: Like count
    - `reply_count` integer: Reply count
    - `retweet_count` integer: Retweet count
    - `quote_count` integer: Quote count
    - `view_count` string, nullable: View count
    - `view_count_state` string, nullable: View count state
    - `author_user_id` string, nullable: Author user ID
    - `author_screen_name` string, nullable: Author screen name
    - `author_name` string, nullable: Author display name
    - `author_is_blue_verified` boolean, nullable: Blue verification flag
    - `author_verified` boolean, nullable: Legacy verification flag
    - `author_is_verified_organization_affiliate` boolean, nullable: Verified organization affiliate flag
  - `has_next_page` boolean, required: Whether another page is available.
  - `next_cursor` string, nullable: Use this cursor to fetch the next page when has_next_page is true.
  - `requested_count` integer, required: Original count requested by the client.
  - `effective_count` integer, required: Count after credit throttling was applied.
  - `parsed_count` integer, required: Number of tweets actually parsed from the response.

## 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)