Instagram Post caption translation API

Get a post's caption text and its translation translation from its url or media_id, and pick the language with target_language, for $6.39 per 1,000 calls.

  • Give url or media_id, one is enough
  • target_language defaults to en
  • source_language gives the detected source language

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "post_translation",
      "params": {
        "url": "https://www.instagram.com/p/DbYmqpplO_N/"
      }
    }
  2. 2JSON response

    {
      "results": {
        "author_username": "n•••a",
        "media_id": "3952078729724096461",
        "shortcode": "DbYmqpplO_N",
        "text": "The Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎\n\nOn Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us!\n\n…",
        …
      }
    }
  3. 3Fields

    author_usernamemedia_idshortcodetext
    n•••a3952078729724096461DbYmqpplO_NThe Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎 On Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us! …
  4. 4CSV

    instagram-post_translation-sample.csv media_id,shortcode,url,author_username,text,translation,source_language,target_language,platform

A request with the post url (or media_id) and the optional target_language returns one JSON object. text is the original and translation is the translated text, ready as a field table or a CSV.

What data you get

The table shows a real call for instagram.com/p/DbYmqpplO_N, captured November 21, 2026 at 07:18 (UTC), that returned one object. Gray bars cover personal information that was removed (••• in the CSV). Your own calls return the fields listed in the field reference.

media_idshortcodeurlauthor_usernametexttranslationsource_languagetarget_languageplatform
3952078729724096461DbYmqpplO_Nhttps://www.instagram.com/reel/DbYmqpplO_N/n•••aThe Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎 On Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us! …The Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎 On Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us! …eneninstagram

Use cases

  • Read a post in another language

    Translate a caption into a language you read, and compare text with translation for the original meaning.

  • Analyze in one language

    Use the same target_language for a batch of posts and keep the translations in one column for keyword counts.

  • Detect the source language

    Read source_language to group posts by language. It is und when the language is not recognized.

  • Hand translations to a team

    Export translation with author_username and url for colleagues who do not read the original language.

Instagram Help Center vs EveryInfra

The Instagram Help Center page on translations (not API documentation) and EveryInfra post_translation, compared on the target language and how you see the translation.

ComparedInstagram Help CenterEveryInfra
Target language"Captions and comments on posts in feed, as well as the bio you include on your profile, are translated automatically based on the language they're written in and the language settings of the person viewing it."target_language takes a language code such as en, zh-CN or es, and defaults to en. When the caption is already in that language, it comes back as it is.
Seeing the translation"If your language is available as a translation, you can tap See Translation below the text to see it."One call returns one object with both text (the original) and translation (the translated text).

Quotes are from the Instagram Help Center, checked 2026-11-22; the page shows no update date. This is a Help Center page, not API documentation. Official sources: See translations for comments, captions and profiles on Instagram

Limits and gotchas

  • Give url or media_id. If you give both, url is used.
  • target_language is a language code such as en, zh-CN, ja, es or pt-BR. It defaults to en.
  • When the caption is already in the target language, it comes back as it is. A post with no caption has no translation.
  • source_language is und when the source language is not recognized.

Pricing

Each call costs $0.006389 and translates one post. Failed calls and empty results are not charged.

CallsCost
10,000$63.89
100,000$638.89
1,000,000$6,388.89

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "post_translation",
  "params": {
    "url": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for post_translation, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Instagram Post caption translation endpoint (instagram/post_translation).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to instagram and action to post_translation, and put the parameters inside params.
- No required parameters.
- Optional parameters:
  - media_id: The numeric post ID (the id in post results). Pass this or url.
  - target_language: The language to translate into, as a language code such as en, zh-CN, zh-TW, ja, ko, es, pt-BR, fr or de. Defaults to en. A caption already in that language comes back as it is.
  - url: A post or Reel link, such as https://www.instagram.com/p/<shortcode>/ or https://www.instagram.com/reel/<shortcode>/. Pass url or media_id; when both are given, url is used.
- Returns one object. Main fields: media_id (The numeric post ID), shortcode (The post shortcode: the part of the pos…), url, author_username, text, translation (The machine translation), source_language (The detected language code of the origi…), target_language (The language code translated into: the…).
- Example request body:
{
  "platform": "instagram",
  "action": "post_translation",
  "params": {
    "url": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}
- Price: $6.39 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesinstagramPlatform identifier, fixed value.
actionbodystringYespost_translationCapability identifier, fixed value.
media_idbody.paramsstringNo-The numeric post ID (the id in post results). Pass this or url.
target_languagebody.paramsstringNo-The language to translate into, as a language code such as en, zh-CN, zh-TW, ja, ko, es, pt-BR, fr or de. Defaults to en. A caption already in that language comes back as it is.
urlbody.paramsstringNo-A post or Reel link, such as https://www.instagram.com/p/<shortcode>/ or https://www.instagram.com/reel/<shortcode>/. Pass url or media_id; when both are given, url is used.

Response example

#
Captured November 21, 2026 at 07:18 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "instagram",  "action": "post_translation",  "results": {    "media_id": "3952078729724096461",    "shortcode": "DbYmqpplO_N",    "url": "https://www.instagram.com/reel/DbYmqpplO_N/",    "author_username": "n•••a",    "text": "The Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎\n\nOn Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us!\n\n…",    "translation": "The Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎\n\nOn Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us!\n\n…",    "source_language": "en",    "target_language": "en",    "platform": "instagram"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
media_idThe numeric post ID. oembed gives it as postID_authorID.
shortcodeThe post shortcode: the part of the post link after /p/ or /reel/.
urlLink to the record on the platform.
author_usernameAuthor's username (@handle), usually usable in URLs.
textBody text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so).
translationThe machine translation. Absent when the post has no caption.
source_languageThe detected language code of the original text, such as en; und when it cannot be detected.
target_languageThe language code translated into: the target_language you passed, or en.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Instagram post translation endpoint return?

One object: media_id, shortcode, url, author_username, text, translation, source_language and target_language.

Which languages can I translate into?

target_language takes a language code such as en, zh-CN, ja or es, and defaults to en. When the caption is already in that language, it comes back as it is.

How much does it cost to translate one post?

Billing is per call: $0.006389 each, or $6.39 per 1,000 calls. Failed calls and empty results are not charged.

Do I need to log in to Instagram to translate a caption?

No. Put your EveryInfra API key in the Authorization: Bearer header. You need no Instagram login and no Instagram access token.

How do post_translation and comment_translations differ?

post_translation translates a post caption; its input is the post url or media_id. comment_translations translates selected comments under a post; it needs url and comment_ids.

The same EveryInfra API key also calls Instagram's other endpoints, such as comment_translations, which translates comments.

Google Analytics needs consent. Privacy