Skip to main content
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.
1 credit per call · All plans from $0.00012/creditDirect MPP at USD 0.00015 per call
Get tweet returns one tweet by numeric ID. The endpoint is GET /api/v1/x/tweets/{id}. See Read Data Richness for every optional tweet, author, and media field.
The examples build tweet lookup rows, not raw response dumps. Use 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, returns 400 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 the x-api-key header value.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. Anonymous calls receive a direct MPP WWW-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.
  • deleted means the author deleted the post.
  • author_deactivated means the post’s author deactivated their X account.
  • author_suspended means X (Twitter) suspended the post’s author.
  • protected means the author limits who can see the post. Another account may still see it.
  • unavailable means X shows the post as unavailable without saying why.
Without 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 the Retry-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." }