Skip to main content
GET
Twitter retweet checker API: did a user repost?
1 credit per check · All plans from $0.00012/credit · Supports guest paid reads

How the check reads

X keeps no list of the reposts one account made of one post. So the check reads the account’s newest posts, up to 3 pages, and stops at the first repost of the post. checkedPosts says how many posts it read.
  • isRetweeted: true names the repost in retweetId and its time in retweetedAt.
  • isRetweeted: false with complete: true means the account never reposted the post.
  • isRetweeted: false with complete: false means no repost among the newest posts. An older repost can exist.
A protected account returns 403 x_account_protected. Xquik charges nothing.

Path parameters

string
required
Post ID or URL-encoded post URL, such as x.com/discord/status/2098439298617856319. See path IDs.

Query parameters

string
required
The account to check: user ID, username with or without @, or profile URL.

Headers

string
Full account key. Sessions and OAuth also work.
string
Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

boolean
Whether the account reposted the post.
string | null
When the account reposted it, else null.
string | null
The ID of the account’s repost, else null.
string
The post checked.
string
The account checked.
number
How many of the account’s newest posts the check read.
boolean
Whether the check read the account’s whole timeline.

400 Invalid tweet ID

400 Invalid user ID

user is missing or invalid.

403 Protected account

404 User not found

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.
Missing or invalid API key.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

The read service returned an error. Retry after a short delay.

429 Rate limit exceeded

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

The normalized v1 response contract can return 424 when the read service is unavailable.