Tweet translation API for X posts in any language

{
  "translation": {
    "tweetId": "2102882545427714266",
    "language": "tr",
    "sourceLanguage": "en",
    "text": "Artemis Anlaşmaları’na Hoş Geldiniz, Hırvatistan https://t.co/Xe1nm2pkSX",
    "entities": {
      "urls": [
        {
          "url": "https://t.co/Xe1nm2pkSX",
          "expanded_url": "https://go.nasa.gov/3VcvAQn",
          "display_url": "go.nasa.gov/3VcvAQn",
          "indices": [
            49
          ]
        }
      ]
    }
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "tweet_not_found",
  "message": "Tweet not found. Check the tweet ID."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

tweets

{id}

translation

Tweet translation API for X posts in any language

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id}/translation

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}/translation"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "translation": {
    "tweetId": "<string>",
    "language": "<string>",
    "sourceLanguage": "<string>",
    "text": "<string>",
    "entities": {}
  }
}

1 credit per call · All plans from $0.00012/credit · Direct MPP: USD 0.00015 per call

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.

curl -G https://xquik.com/api/v1/x/tweets/2102882545427714266/translation \
  --data-urlencode "language=tr" \
  -H "x-api-key: xq_your_api_key_here" | jq

const tweetId = "2102882545427714266";
const params = new URLSearchParams({ language: "tr" });
const response = await fetch(`https://xquik.com/api/v1/x/tweets/${tweetId}/translation?${params}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const { translation } = await response.json();
const translationRow = {
  tweet_id: translation.tweetId,
  source_language: translation.sourceLanguage ?? null,
  language: translation.language,
  text: translation.text,
  links: (translation.entities.urls ?? []).map((link) => link.expanded_url),
};

process.stdout.write(`${JSON.stringify(translationRow)}\n`);

import json
import requests

tweet_id = "2102882545427714266"
response = requests.get(
    f"https://xquik.com/api/v1/x/tweets/{tweet_id}/translation",
    params={"language": "tr"},
    headers={"x-api-key": "xq_your_api_key_here"},
)
translation = response.json()["translation"]
translation_row = {
    "tweet_id": translation["tweetId"],
    "source_language": translation.get("sourceLanguage"),
    "language": translation["language"],
    "text": translation["text"],
    "links": [link["expanded_url"] for link in translation["entities"].get("urls", [])],
}
print(json.dumps(translation_row))

Use 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 carry lang, 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

string

required

Post ID or URL-encoded post URL, such as x.com/nasa/status/20. See path IDs.

Query parameters

string

required

Language code to translate into, such as en, tr, pt-br, or zh-tw. Any letter case works, and pt_BR reads as pt-br. A language name, such as turkish, returns 400 invalid_language.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here authenticates paid_reads guest keys. Direct MPP uses the Payment ... credential. Get it from the WWW-Authenticate: Payment challenge.

Response

200 OK

object

X’s translation of the tweet. Translation object fields.

string

ID of the translated tweet.

string

Language code of the translated text, in lower case.

string

Language code X detects in the tweet. Omitted when X names none.

string

Translated tweet text.

object

Links, mentions, and tags with their offsets in the translated text. Empty when the text has none.

{
  "translation": {
    "tweetId": "2102882545427714266",
    "language": "tr",
    "sourceLanguage": "en",
    "text": "Artemis Anlaşmaları’na Hoş Geldiniz, Hırvatistan https://t.co/Xe1nm2pkSX",
    "entities": {
      "urls": [
        {
          "url": "https://t.co/Xe1nm2pkSX",
          "expanded_url": "https://go.nasa.gov/3VcvAQn",
          "display_url": "go.nasa.gov/3VcvAQn",
          "indices": [49, 72]
        }
      ]
    }
  }
}

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

{ "error": "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" }

The tweet does not exist. The author may have deleted it, or the ID is invalid.

502 X API unavailable

{ "error": "x_api_unavailable" }

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

503 Service busy

{ "error": "x_api_unavailable" }

X returned no translation, or Xquik is busy. Retry after a short delay. The request costs nothing.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

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

424 Dependency failed

{ "error": "x_api_unavailable" }

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?

Call GET /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, such as en, es, tr, ja, or pt-br. A code that names no language returns 400 invalid_language and costs nothing.

How do I know the tweet’s original language?

Read translation.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, or Search Tweets finds tweets to translate.

{
  "translation": {
    "tweetId": "2102882545427714266",
    "language": "tr",
    "sourceLanguage": "en",
    "text": "Artemis Anlaşmaları’na Hoş Geldiniz, Hırvatistan https://t.co/Xe1nm2pkSX",
    "entities": {
      "urls": [
        {
          "url": "https://t.co/Xe1nm2pkSX",
          "expanded_url": "https://go.nasa.gov/3VcvAQn",
          "display_url": "go.nasa.gov/3VcvAQn",
          "indices": [
            49
          ]
        }
      ]
    }
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "tweet_not_found",
  "message": "Tweet not found. Check the tweet ID."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Tweet translation API for X posts in any language

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id}/translation

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}/translation"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "translation": {
    "tweetId": "<string>",
    "language": "<string>",
    "sourceLanguage": "<string>",
    "text": "<string>",
    "entities": {}
  }
}

​Translate tweets for a multilingual feed

​Path parameters

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid language

​400 Invalid tweet ID

​401 Unauthenticated

​402 Payment required

​404 Tweet not found

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​Tweet translation API questions

​How do I translate a tweet with an API?

​Which languages can I translate a tweet into?

​How do I know the tweet’s original language?

​How much does a tweet translation cost?

​Does this replace X’s official API?

Translate tweets for a multilingual feed

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid language

400 Invalid tweet ID

401 Unauthenticated

402 Payment required

404 Tweet not found

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Tweet translation API questions

How do I translate a tweet with an API?

Which languages can I translate a tweet into?

How do I know the tweet’s original language?

How much does a tweet translation cost?

Does this replace X’s official API?