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
urlormedia_id, one is enough target_languagedefaults toensource_languagegives the detected source language
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "instagram", "action": "post_translation", "params": { "url": "https://www.instagram.com/p/DbYmqpplO_N/" } }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…", … } }3Fields
author_username media_id shortcode text n•••a 3952078729724096461 DbYmqpplO_N 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! … 4CSV
instagram-post_translation-sample.csv media_id,shortcode,url,author_username,text,translation,source_language,target_language,platform
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_id | shortcode | url | author_username | text | translation | source_language | target_language | platform |
|---|---|---|---|---|---|---|---|---|
| 3952078729724096461 | DbYmqpplO_N | https://www.instagram.com/reel/DbYmqpplO_N/ | n•••a | 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! … | 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! … | en | en |
Use cases
Read a post in another language
Translate a caption into a language you read, and compare
textwithtranslationfor the original meaning.Analyze in one language
Use the same
target_languagefor a batch of posts and keep the translations in one column for keyword counts.Detect the source language
Read
source_languageto group posts by language. It isundwhen the language is not recognized.Hand translations to a team
Export
translationwithauthor_usernameandurlfor 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.
| Compared | Instagram Help Center | EveryInfra |
|---|---|---|
| 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
urlormedia_id. If you give both,urlis used. target_languageis a language code such asen,zh-CN,ja,esorpt-BR. It defaults toen.- When the caption is already in the target language, it comes back as it is. A post with no caption has no
translation. source_languageisundwhen the source language is not recognized.
Pricing
Each call costs $0.006389 and translates one post. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $63.89 |
| 100,000 | $638.89 |
| 1,000,000 | $6,388.89 |
Totals use the list price per call.
Code samples
#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.
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
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | instagram | Platform identifier, fixed value. |
action | body | string | Yes | post_translation | Capability identifier, fixed value. |
media_id | body.params | string | No | - | The numeric post ID (the id in post results). Pass this or url. |
target_language | body.params | string | No | - | 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 | body.params | string | No | - | 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
#{ "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.
| Field | Meaning |
|---|---|
media_id | The numeric post ID. oembed gives it as postID_authorID. |
shortcode | The post shortcode: the part of the post link after /p/ or /reel/. |
url | Link to the record on the platform. |
author_username | Author's username (@handle), usually usable in URLs. |
text | Body 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). |
translation | The machine translation. Absent when the post has no caption. |
source_language | The detected language code of the original text, such as en; und when it cannot be detected. |
target_language | The language code translated into: the target_language you passed, or en. |
platform | Source 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.
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.
Related Instagram endpoints
The same EveryInfra API key also calls Instagram's other endpoints, such as comment_translations, which translates comments.
- Post details
post$0.56 per 1,000 callsFetch one or more Instagram posts or Reels from the links inurls. - Details
profile$0.56 per 1,000 callsLook up an Instagram account by handle or profile URL. - Account insights
persona$0.56 per 1,000 callsGet an account overview for an Instagram handle, built from its public profile. - Posts by user
user_posts$0.56 per 1,000 callsList posts from an Instagram account byusername, each with caption, media type, likes, comments, views, location, hashtags and top comments. - Content discovery
discover$0.56 per 1,000 callsTrack posts under an Instagram hashtag passed inkeyword. - Comments
comments$0.79 per 1,000 callsRead comments on one Instagram post or Reel aturl. - Reels
reels$1.19 per 1,000 callsPull an Instagram account's Reels byusername, with caption, play count, duration in seconds, likes, comments, hashtags, music and video link. - Hashtag
hashtag$0.56 per 1,000 callsCollect posts for an Instagram hashtag inhashtag, without the # sign. - Followers
followers$0.56 per 1,000 callsSee the follower and following counts of an Instagram account byusername. - Follower list
followers_list$0.56 per 1,000 callsList the accounts that follow an Instagram user, byusername, with handle, name, avatar, private and verified flags and relation type. - Following list
following_list$0.56 per 1,000 callsList the accounts an Instagram user follows, byusername, with handle, name, avatar, private and verified flags and relation type. - Account search
user_search$4.81 per 1,000 callsSearch Instagram accounts bykeyword, in the order Instagram search ranks them for that word. - Reels search
reels_search$7.19 per 1,000 callsSearch Instagram Reels bykeyword, such as coffee. - Similar accounts
similar_profiles$8.81 per 1,000 callsFind accounts Instagram suggests as similar to one account, byusernamesuch as nasa. - Tagged posts
tagged_posts$7.44 per 1,000 callsList public posts by other accounts that tag one Instagram account, given asusername, profile URL or numeric user ID. - Stories
stories$1.5 per 1,000 callsGet the stories an Instagram account has live right now, from its username. - Story highlights
highlights$1.6 per 1,000 callsList the story highlights on an Instagram profile. - Comment replies
comment_replies$0.88 per 1,000 callsRead the replies under one comment on an Instagram post or Reel, from the post link and the comment'sidreturned bycomments. - Post likers
likers$1.32 per 1,000 callsList the accounts that liked one Instagram post or Reel, from itsurl. - Posts at a location
location_posts$0.56 per 1,000 callsList the posts tagged at one Instagram location, fromlocation_id(theidin a post'slocation_detail, or a location page link). - Reels using a music track
audio_posts$0.56 per 1,000 callsList the Instagram Reels that use one piece of music, fromaudio_id(theaudio_idin a post'smusic, or an audio page link). - Explore
explore$0.56 per 1,000 callsRead one page of the posts Instagram recommends on Explore; no input is needed. - Engagement statistics
engagement$0.56 per 1,000 callsWork out an Instagram account's engagement from its latest posts, byusername. - Profile by numeric ID
profile_by_id$0.56 per 1,000 callsLook up an Instagram account from its numericuser_id. - About this account
user_about$0.56 per 1,000 callsRead the About this account panel of an Instagram profile byusername: the month it joined (joined_at), itscountry, how many times it changed its username (former_usernames_count) and when it was verified. - Location details
location_info$0.56 per 1,000 callsRead one Instagram location from itslocation_id: name, category, coordinates (lat,lng), address details when listed, andpost_count. - Link recognition
resolve_links$0.56 per 1,000 callsConvert one Instagram post reference intext(a post link, a shortcode or a numeric post ID) into all three:shortcode,media_idandurl. - Post embed code
oembed$0.56 per 1,000 callsGet the oEmbed data and embed code for one Instagram post or Reel from itsurl: the same fields as Instagram's official oEmbed, withhtmlready to paste into a web page. - Nearby locations
location_nearby$0.56 per 1,000 callsList the locations Instagram shows near one location, from itslocation_id: about 20 rows in one call, no next page. - Hashtag search
hashtag_search$0.56 per 1,000 callsFind Instagram hashtags for akeyword: the hashtags Instagram's search box suggests, withpost_countfor each. - Stories in a highlight
highlight_stories$0.56 per 1,000 callsRead every story in one Instagram highlight fromhighlight_id(theidfromhighlights, or a highlight link): up to 100 stories in one call, with media links,posted_atandduration_seconds. - Comment translations
comment_translations$6.39 per 1,000 callsTranslate up to 10 comments on one Instagram post, from the posturlandcomment_ids, intotarget_language(defaulten). - Recommended Reels
recommended_reels$1.18 per 1,000 callsRead the Reels Instagram recommends on its Reels page, 10 per page; no input is needed. - User reposts
user_reposts$0.56 per 1,000 callsList the posts and Reels an Instagram account reposted to its profile, byusername, 12 per page. - Cities in a country
location_cities$0.56 per 1,000 callsList the cities Instagram's location directory has for onecountry_code, 96 per page. - Locations in a city
city_locations$0.56 per 1,000 callsList the locations Instagram's location directory has for one city, fromcity_id, 96 per page. - Profiles in bulk
profiles_batch$0.56 per 1,000 callsLook up as many as 20 Instagram accounts at once fromusernames, each given as a username such asnatgeoor a profile link.