Instagram 帖子正文翻译 API

按帖子的 url 或 media_id 取正文 text 和译文 translation,用 target_language 选目标语言,每千次 $6.39。

  • url 和 media_id 给一个就行
  • target_language 不传是 en
  • source_language 标出识别出的原文语言
免费开始

接口健康状态

24h 健康值
正常
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

24 小时趋势

30 天趋势

  1. 1请求

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

    {
      "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. 3字段

    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

请求带帖子 url(或 media_id)和可选的 target_language;返回一个 JSON 对象,text 是原文,translation 是译文,列成字段表,也可下载为 CSV。

能拿到什么数据

下表是对 instagram.com/p/DbYmqpplO_N 的一次真实调用,采集于 2026年11月21日 15:18(UTC),返回一个对象;灰条是隐去的个人信息(CSV 里是 •••)。你自己调用时,按字段表返回这些字段。

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

用途

  • 读懂外语帖子

    把帖子正文译成你读得懂的语言,对照 text 和 translation 看原意。

  • 统一成一种语言分析

    同一批帖子用同一个 target_language,译文放在一列里,方便做关键词统计。

  • 识别原文语言

    读 source_language,按语言给帖子分组;认不出时是 und。

  • 给运营团队出译文

    把 translation 连同 author_username 和 url 一起导出,交给不懂原文语言的同事。

Instagram Help Center 与 EveryInfra 对比

下面从译成哪种语言、怎么看译文两方面,比 Instagram 帮助中心讲翻译的页面(不是接口文档)和 EveryInfra post_translation。

对比项Instagram Help CenterEveryInfra
译成哪种语言"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 传语言代码,如 en、zh-CN、es,不传是 en;正文本来就是这种语言时原样返回。
怎么看译文"If your language is available as a translation, you can tap See Translation below the text to see it."一次调用返回一个对象,同时有 text(原文)和 translation(译文)。

引文出自 Instagram 帮助中心,2026-11-22 核对;页面没有标更新日期。这是帮助中心的页面,不是接口文档。 官方出处: See translations for comments, captions and profiles on Instagram

限制和注意事项

  • url 和 media_id 给一个就行,两个都给按 url。
  • target_language 填语言代码,如 en、zh-CN、ja、es、pt-BR,不传是 en。
  • 正文本来就是目标语言时原样返回;帖子没有正文时没有 translation。
  • source_language 认不出原文语言时是 und。

价格

每次调用 $0.006389,按次计费;一次调用译一条帖子。失败和空结果不收费。

调用次数费用
10,000$63.89
100,000$638.89
1,000,000$6,388.89

合计按每次调用的标价算。

代码示例

#
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 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。

url 填帖子链接,也可以改填 media_id;target_language 不填时译成英语。

API 参考

下面是 post_translation 的参数、响应字段、错误和计费,可以复制整页,或用 Markdown 打开后交给 AI 助手。

POST

AI 提示词

#
请帮我用 EveryInfra 的「Instagram 帖子正文翻译」接口(instagram/post_translation)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 instagram,action 填 post_translation,参数放在 params 里。
- 没有必填参数。
- 可选参数:
  - media_id:帖子的数字编号(post 结果里的 id)。和 url 给一个。
  - target_language:译成哪种语言,语言代码,如 en、zh-CN、zh-TW、ja、ko、es、pt-BR、fr、de;不传是 en。正文本来就是这种语言时原样返回。
  - url:帖子或 Reel 链接,如 https://www.instagram.com/p/<shortcode>/。url 和 media_id 给一个,两个都给按 url。
- 返回一个对象,主要字段:media_id(帖子的数字编号)、shortcode(帖子码:帖子链接里 /p/ 或 /…)、url、author_username、text、translation(译文(机器翻译))、source_language(识别出来的原文语言代码)、target_language(译成的语言代码)。
- 示例请求体:
{
  "platform": "instagram",
  "action": "post_translation",
  "params": {
    "url": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}
- 计费:$6.39 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是instagram平台标识,固定值。
actionbodystring是post_translation能力标识,固定值。
media_idbody.paramsstring否-帖子的数字编号(post 结果里的 id)。和 url 给一个。
target_languagebody.paramsstring否-译成哪种语言,语言代码,如 en、zh-CN、zh-TW、ja、ko、es、pt-BR、fr、de;不传是 en。正文本来就是这种语言时原样返回。
urlbody.paramsstring否-帖子或 Reel 链接,如 https://www.instagram.com/p/<shortcode>/。url 和 media_id 给一个,两个都给按 url。

响应示例

#
2026年11月21日 15:18(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息;id、billing、quota 每次调用都不同,只给结构。
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": { … }}

返回字段

#

业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。

字段含义
media_id帖子的数字编号。oembed 给的是「帖子编号_作者编号」的写法。
shortcode帖子码:帖子链接里 /p/ 或 /reel/ 后面那一段。
url该记录在原平台上的可访问链接。
author_username作者用户名(@handle),通常可用于拼 URL。
text正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
translation译文(机器翻译)。帖子没有正文时不出现。
source_language识别出来的原文语言代码,如 en;认不出时是 und。
target_language译成的语言代码,就是你传的 target_language,没传是 en。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

错误与计费

#
401
缺少 Key 或 Key 无效。
402
余额不足,先充值。
422
参数名或取值不对,按错误信息给的候选改;不扣费。
429
超过每分钟请求上限,按 Retry-After 等待后再试。
503
暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
200 空结果
没有数据,不扣费。

错误码

官方资料参照

#

只用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。

  • Instagram 帮助中心:评论、帖子文字和简介的翻译 ↗

    Instagram 帮助中心说明,信息流里帖子的文字、评论和主页简介会按文字所用的语言和查看者的语言设置自动翻译,点文字下方的 See Translation 查看。可证明帖子正文翻译和评论翻译是 Instagram 的官方功能;不证明本接口的 target_language 可任选,不证明 text、translation、source_language 的取值,也不证明 comment_ids 取评论的方式和约前 150 条的范围。

    核对于 2026-11-21

常见问题

Instagram 帖子翻译接口返回什么?

返回一个对象:media_id、shortcode、url、author_username、text、translation、source_language、target_language。

译成哪些语言?

target_language 填语言代码,如 en、zh-CN、ja、es;不传是 en。正文本来就是这种语言时原样返回。

翻译一条帖子多少钱?

每次 $0.006389,每千次 $6.39,按调用次数算。失败和空结果不收费。

翻译帖子正文要登录 Instagram 吗?

不用。请求头里放一把 EveryInfra API Key(Authorization: Bearer),不用登录 Instagram,也不用 Instagram 访问令牌。

post_translation 和 comment_translations 有什么区别?

post_translation 译帖子的正文,输入是帖子 url 或 media_id。comment_translations 译帖子下选定的评论,要 url 和 comment_ids。

同一把 Key 还能调用 Instagram 的其他能力,比如翻译评论的 comment_translations。

Google Analytics 同意才加载 隐私