GET https://xquik.com/api/v1/x/tweets/{id}
Repost records include
retweetedAt, the repost event’s UTC ISO 8601 timestamp. It is null when
that timestamp is unavailable. The API omits it for original posts. The nested original post keeps
its own creation date. This field does not report every account that reposted a post. Request
per-account timestamps with Get retweeters.GET /api/v1/x/tweets/{id}.
See Read Data Richness for every optional tweet,
author, and media field.
GET /api/v1/x/tweets/{id} when a workflow needs one tweet plus author context.
Store tweet_id, text, author_id, author_username, author_followers,
author_verified, author_profile_picture, created_at, conversation_id,
and is_reply. Also store is_quote_status, is_note_tweet, tweet_source,
quote_tweet_id, metrics, and media_urls. Keep these fields with the record
you pass on.
Direct tweet handoff
Pass a post ID or a URL-encoded post URL in the path. Other input, such as a username, returns400 invalid_tweet_id. Use the response when
you need 1 record. It has normalized tweet text, optional author data,
engagement counts, and quote metadata. It also has conversation context, Note
Tweet text, source, and media URLs.Store a tweet lookup record
Use the numeric Tweet ID as the stable key. Keep text, author, thread, quote, engagement, media, and disclosure fields as separate columns. You cannot search one merged value.Direct tweet reads cost 1 credit per successful call. For MPP callers,
this endpoint bills a fixed charge of USD 0.00015 per call.
Path parameters
Which tweet endpoint?
One tweet by ID
Use
GET /x/tweets/{id} for one tweet. It returns text, author, media,
quote or reply flags, metrics, and Note Tweet text.Many tweet IDs
Use
Get tweets (batch) when you already
have multiple numeric IDs.Keyword or advanced search
Use
Search tweets when you need keyword,
operator, author, date, media, engagement, or verification filters. Also use
it when you need pasted Tweet URL exact lookup.Thread context
Use
Get tweet thread when the next action
needs surrounding conversation rows.Engagement lists
You may need users or tweets connected to this tweet. If so, use
replies, quote tweets, retweeters, or favoriters pages.
Saved exports
Use
Create extraction for CSV, JSON,
or XLSX output. Use it with reply_extractor, quote_extractor,
repost_extractor, thread_extractor, or tweet_search_extractor.Query parameters
Headers
Response
200 OK
400 Invalid tweet ID
{ "error": "invalid_tweet_id" }
The provided tweet ID is empty or not a valid format.401 Unauthenticated
Missing or invalid API key. Check thex-api-key header value.402 Payment required
Account keys get account options. Guest keys get guest top-up only. Anonymous calls receive a direct MPPWWW-Authenticate: Payment challenge plus a guest wallet creation action.
No checkout starts automatically. Confirm any payment action.404 Tweet not found
{ "error": "tweet_not_found", "reason": "author_suspended", "message": "X suspended this post's author." }
X shows no post with this ID. reason says why when X names it.deletedmeans the author deleted the post.author_deactivatedmeans the post’s author deactivated their X account.author_suspendedmeans X (Twitter) suspended the post’s author.protectedmeans the author limits who can see the post. Another account may still see it.unavailablemeans X shows the post as unavailable without saying why.
reason, X named no cause. Check the tweet ID.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 theRetry-After header before retrying.424 Dependency failed
The normalized v1 response contract can return 424 when the read service is unavailable.Next steps. Search Tweets to find tweets by query. Get User to look up the author profile.
Response examples
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 404
{ "error": "tweet_not_found", "message": "Tweet not found. Check the tweet ID." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 } - 502
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 503
{ "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }