GET https://xquik.com/api/v1/x/tweets/{id}/translation
Translate tweet returns X’s own translation of one public tweet.
You pick the language. The endpoint is GET /api/v1/x/tweets/{id}/translation.
GET /x/tweets/{id}/translation when a reader needs a tweet in another language.
The text is X’s own translation, as x.com shows it under the post.
Each call costs 1 credit. A refused request costs nothing.
Translate tweets for a multilingual feed
Read tweets with Search Tweets or Get tweet. Most tweets carrylang, the language code X detects.
Call this endpoint only for tweets whose lang differs from your reader’s language.
Store tweetId, language, and text together.
A stored translation saves a second call for the same tweet and language.
entities holds the links, mentions, and tags of the translated text.
Their indices point into text, so you can link them without parsing.Path parameters
Query parameters
Choose fields
Headers
Response
200 OK
400 Invalid language
{ "error": "invalid_language", "message": "Send language as a language code, such as en, tr, pt-br or zh-tw." }
language is missing or is not a language code. Send a code, not a language name.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
The tweet does not exist. The author may have deleted it, or the ID is invalid.502 X API unavailable
The read service returned an error. Retry after a short delay.503 Service busy
X returned no translation, or Xquik is busy. Retry after a short delay. The request costs nothing.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.Tweet translation API questions
How do I translate a tweet with an API?
CallGET /x/tweets/{id}/translation with the tweet ID and a language code.
The response holds the translated text in translation.text.Which languages can I translate a tweet into?
Send any language code X translates into. Examples areen, es, tr, ja, and pt-br.
A code that names no language returns 400 invalid_language and costs nothing.How do I know the tweet’s original language?
Readtranslation.sourceLanguage. It holds the language code X detects in the tweet.
The field is absent when X names no language.How much does a tweet translation cost?
Each call costs 1 credit. A refused or failed request costs nothing.Does this replace X’s official API?
No. This page documents Xquik, an independent third-party service. It does not document X’s official API.Next steps. Get tweet reads the original text and its
lang. Search Tweets finds tweets to translate.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." }