Sign in
Users

List the newest tweets of multiple users in one call

Changed on

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). Duplicate IDs are ignored while preserving first-seen order.

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.

pageSizeinteger

Posts per user (1-20, default 20). Credits can return fewer. Aliases: limit, count, max_results, maxItems, max_items & per_page.

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

  • bb04c4ae80e4Revision changes
    • ○

      added the optional property /////// to the response with the status

  • 7383c6553bf6Revision changes
    • ▲

      the response property ///// became optional for the status

    • ○

      added the optional property //// to the response with the status

    • ○

      added the optional property ////////// to the response with the status

Of the 51 revisions, 1 has no diff computed.