# Instagram Post caption translation API (instagram.post_translation)

- Canonical page: [https://everyinfra.com/en/instagram-api/post_translation](https://everyinfra.com/en/instagram-api/post_translation?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "instagram", "action": "post_translation", "params": {...}}
- Price: $0.006389 per call ($6.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=instagram&action=post_translation

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| media_id | not declared | no | not declared | The numeric post ID (the `id` in `post` results). Pass this or `url`. |
| target_language | not declared | no | not declared | 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 | not declared | no | not declared | 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 fields (items in `results`)

| 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). |

## Example

```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/"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "instagram",
        "action": "post_translation",
        "params": {
            "url": "https://www.instagram.com/p/DbYmqpplO_N/",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-11-21T07:18:47Z. `results` and `count` are real 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.

```text
{
  "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": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=instagram
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
