Engagement
Twitter retweet checker API: did a user repost?
Check whether one X account reposted a tweet, with the repost time & ID, for giveaway & campaign proof. Reads the account’s newest posts. 1 credit per check.
- 200
- 400
- 401
- 402
- 403
- 404
- 424
- 429
- 502
- 503
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: truenames the repost inretweetIdand its time inretweetedAt.isRetweeted: falsewithcomplete: truemeans the account never reposted the post.isRetweeted: falsewithcomplete: falsemeans no repost among the newest posts. An older repost can exist.
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 getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.
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
429 Rate limit exceeded
Retry-After header before retrying.
424 Dependency failed
Related. Retweeters · Check follower · Get tweet