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

# Get User Articles by Page

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

## Request

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

Fetch one page of X Articles by screen_name. Requires only a TwexAPI Bearer key. The request body is optional; omitted or null count defaults to 20, and integer values are clamped to 1–20. Pass next_cursor from the previous response to continue. The current implementation returns a continuation cursor only when at least count articles were parsed and the upstream supplied a cursor; a short or empty page therefore ends pagination. A missing user or exhausted result quota returns an empty page.

## Path parameters

- `screen_name` string, required

## Request body

- UserArticlesPageBody, nullable
  - `count` integer, nullable: Omitted or null uses 20. Values below 1 are clamped to 1 and values above 20 to 20.
  - `next_cursor` string, nullable: Continuation cursor; omit, use null or an empty string for the first page.

## Response `200`

Success

- UserArticlesPageResponse
  - `code` integer, required
  - `msg` string, required
  - `data` XArticleModel[], required
    - `tweet_id` string, nullable: The ID of the tweet
    - `full_text` string, nullable: The full text of the article tweet
    - `created_at` string, nullable: The creation time
    - `lang` string, nullable: The language
    - `bookmark_count` integer, nullable: Bookmark count
    - `favorite_count` integer, nullable: Favorite count
    - `reply_count` integer, nullable: Reply count
    - `retweet_count` integer, nullable: Retweet count
    - `quote_count` integer, nullable: Quote count
    - `view_count` string, nullable: View count
    - `view_count_state` string, nullable: View count state
    - `conversation_id` string, nullable: Conversation ID
    - `author_user_id` string, nullable: Author user ID
    - `author_screen_name` string, nullable: Author screen name
    - `author_name` string, nullable: Author name
    - `author_is_blue_verified` boolean, nullable: Whether author is blue verified
    - `author_verified` boolean, nullable: Whether author is verified
    - `author_is_verified_organization_affiliate` boolean, nullable: Whether author is verified organization
    - `article_id` string, nullable: Article ID
    - `article_title` string, nullable: Article title
    - `article_preview_text` string, nullable: Article preview text
    - `article_summary_text` string, nullable: Article summary text
    - `article_cover_image_url` string, nullable: Article cover image URL
    - `article_blocks` ArticleBlock[]: Article formatting blocks
      - `type` string, required: The type of the article block.
      - `text` string, required: The text of the article block.
      - `entityRanges` ArticleBlockRange[]: The entity ranges of the article block.
        - `key` integer, required: The key of the entity range.
        - `length` integer, required: The length of the entity range.
        - `offset` integer, required: The offset of the entity range.
    - `article_plain_text` string, nullable: Article plain text
    - `article_markdown` string, nullable: Article markdown
    - `article_media_image_urls` string[]: Article media image URLs
  - `has_next_page` boolean, required
  - `next_cursor` string, nullable, required: Pass unchanged on the next request; null when no continuation is available.

## Other responses

- `403`: Authentication or credit access denied
- `422`: Invalid request
- `500`: Upstream or server 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)