GET /api/v1/x/users/batch/tweets

Users

Changed on Oct 20, 2026

Returns the newest posts of up to 20 users, named by user ID, username or profile link, in the order named. Send ids or usernames, not both. Each post costs 1 credit. A user in unavailable_ids or unprocessed_ids costs nothing.

get/api/v1/x/users/batch/tweets

Request

Base URL: https://xquik.com
URL: https://xquik.com/api/v1/x/users/batch/tweets
Auth: one of:
- API key in header x-api-key
- HTTP bearer
- none

Query parameters

idsstring

Comma-separated numeric user IDs (1-20 values). Xquik ignores duplicate IDs and keeps the first-seen order. A longer URL fails at the edge before Xquik reads it.

usernamesstring

Comma-separated X usernames, with or without @, or profile links such as x.com/nasa (1-20 values), in place of ids. A name in another case is the same account. A number is a user ID. A longer URL fails at the edge before Xquik reads it.

pageSizeinteger

Posts per user (1-20, default 20). A low credit balance can return fewer. Its aliases are limit, count, max_results, maxItems, max_items & per_page.

fieldsstring

Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it.

omitstring

Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

Each user's newest posts, plus the users not read.

has_next_pagefalse required

Always false. The answer holds every post in 1 page.

next_cursorstring required

Always empty. The answer holds every post in 1 page.

unavailable_idsstring[] required

Users with no account on X or with protected posts, in first-seen request order. They cost nothing.

unprocessed_idsstring[] required

Users the call did not read, in first-seen request order. Their read failed, the call ran out of time or credits ran out. They cost nothing. Send them again.

Example response

{
  "tweets": [
    {
      "id": "1234567890",
      "text": "Just launched our new feature!",
      "createdAt": "2025-01-15T12:00:00Z",
      "likeCount": 42,
      "retweetCount": 5,
      "replyCount": 3,
      "quoteCount": 1,
      "viewCount": 1500,
      "bookmarkCount": 2,
      "author": {
        "id": "9876543210",
        "username": "elonmusk",
        "name": "Elon Musk",
        "verified": true
      }
    }
  ],
  "unavailable_ids": [
    "1234567890"
  ],
  "unprocessed_ids": []
}

Changes

Oct 20, 202645942c75fdc2 Revision changes
- warning
  added the new topup_in_progress enum value to the ///// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status

Operation history