API de Traducción de una publicación de Instagram
Obtén el texto text de una publicación y su traducción translation a partir de su url o media_id, y elige el idioma con target_language, por $6.39 por cada 1000 llamadas.
- Da
urlomedia_id, con uno basta target_languageesenpor defectosource_languageda el idioma de origen detectado
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "instagram", "action": "post_translation", "params": { "url": "https://www.instagram.com/p/DbYmqpplO_N/" } }2Respuesta JSON
{ "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…", … } }3Campos
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 de la publicación (o media_id) y el opcional target_language, y devuelve un objeto JSON. text es el original y translation el texto traducido, listo como tabla de campos o CSV.Qué datos obtienes
La tabla muestra una llamada real para instagram.com/p/DbYmqpplO_N, capturada el 21 de noviembre de 2026, 07:18 (UTC), que devolvió un objeto. Las barras grises tapan datos personales que se quitaron (••• en el CSV). Tus llamadas devuelven los campos de la referencia de campos.
| 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 |
Casos de uso
Lee una publicación en otro idioma
Traduce un texto a un idioma que leas y compara
textcontranslationpara ver el sentido original.Analiza todo en un idioma
Usa el mismo
target_languagepara un lote de publicaciones y deja las traducciones en una columna para contar palabras clave.Detecta el idioma de origen
Lee
source_languagepara agrupar las publicaciones por idioma. Valeundcuando no se reconoce el idioma.Pasa las traducciones a un equipo
Exporta
translationjunto conauthor_usernameyurlpara compañeros que no leen el idioma original.
Centro de ayuda de Instagram frente a EveryInfra
Comparación entre la página del Centro de ayuda de Instagram sobre traducciones (no es documentación de API) y post_translation de EveryInfra: idioma de destino y cómo se ve la traducción.
| Aspecto | Centro de ayuda de Instagram | EveryInfra |
|---|---|---|
| Idioma de destino | "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 admite un código de idioma como en, zh-CN o es, y por defecto es en. Si el texto ya está en ese idioma, se devuelve tal cual. |
| Ver la traducción | "If your language is available as a translation, you can tap See Translation below the text to see it." | Una llamada devuelve un objeto con text (el original) y translation (el texto traducido). |
Las citas proceden del Centro de ayuda de Instagram, comprobadas el 2026-11-22; la página no muestra fecha de actualización. Es una página del Centro de ayuda, no documentación de API. Fuentes oficiales: See translations for comments, captions and profiles on Instagram
Límites y detalles a tener en cuenta
- Da
urlomedia_id. Si das los dos, se usaurl. target_languagees un código de idioma comoen,zh-CN,ja,esopt-BR. Por defecto esen.- Si el texto ya está en el idioma de destino, se devuelve tal cual. Una publicación sin texto no tiene
translation. source_languageesundcuando no se reconoce el idioma de origen.
Precios
Cada llamada cuesta $0.006389 y traduce una publicación. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 10,000 | $63.89 |
| 100,000 | $638.89 |
| 1,000,000 | $6,388.89 |
Los totales usan el precio de lista por llamada.
Ejemplos de código
#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/"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Referencia de API
Consulta los parámetros, los campos de respuesta, los errores y la facturación de post_translation, y copia la página o ábrela como Markdown para un asistente de IA.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Instagram: Traducción de una publicación (instagram/post_translation).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en instagram y action en post_translation, y los parámetros dentro de params.
- No hay parámetros obligatorios.
- Parámetros opcionales:
- media_id: ID numérico de la publicación (el id de post). Pasa este o url.
- target_language: Idioma al que traducir, como código de idioma: en, zh-CN, zh-TW, ja, ko, es, pt-BR, fr o de. Por defecto en. Un texto que ya está en ese idioma se devuelve tal cual.
- url: Enlace de una publicación o Reel, como https://www.instagram.com/p/<shortcode>/ o https://www.instagram.com/reel/<shortcode>/. Pasa url o media_id; si das los dos, se usa url.
- Devuelve un objeto. Campos principales: media_id (ID numérico de la publicación), shortcode (Shortcode de la publicación: la parte d…), url, author_username, text, translation (La traducción automática), source_language (Código del idioma detectado del texto o…), target_language (Código del idioma de la traducción: el…).
- Cuerpo de solicitud de ejemplo:
{
"platform": "instagram",
"action": "post_translation",
"params": {
"url": "https://www.instagram.com/p/DbYmqpplO_N/"
}
}
- Precio: $6.39 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | instagram | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | post_translation | Identificador de la capacidad, valor fijo. |
media_id | body.params | string | No | - | ID numérico de la publicación (el id de post). Pasa este o url. |
target_language | body.params | string | No | - | Idioma al que traducir, como código de idioma: en, zh-CN, zh-TW, ja, ko, es, pt-BR, fr o de. Por defecto en. Un texto que ya está en ese idioma se devuelve tal cual. |
url | body.params | string | No | - | Enlace de una publicación o Reel, como https://www.instagram.com/p/<shortcode>/ o https://www.instagram.com/reel/<shortcode>/. Pasa url o media_id; si das los dos, se usa url. |
Ejemplo de respuesta
#{ "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": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
media_id | ID numérico de la publicación. oembed lo da como IDpublicación_IDautor. |
shortcode | Shortcode de la publicación: la parte del enlace después de /p/ o /reel/. |
url | Enlace al registro en la plataforma. |
author_username | Nombre de usuario del autor (@usuario), normalmente utilizable en URL. |
text | Texto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma). |
translation | La traducción automática. No aparece cuando la publicación no tiene texto. |
source_language | Código del idioma detectado del texto original, como en; und cuando no se detecta. |
target_language | Código del idioma de la traducción: el target_language que pasaste, o en. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Preguntas frecuentes
¿Qué devuelve el endpoint de traducción de publicaciones de Instagram?
Un objeto: media_id, shortcode, url, author_username, text, translation, source_language y target_language.
¿A qué idiomas puedo traducir?
target_language admite un código de idioma como en, zh-CN, ja o es, y por defecto es en. Si el texto ya está en ese idioma, se devuelve tal cual.
¿Cuánto cuesta traducir una publicación?
Se cobra por llamada: $0.006389 cada una, o $6.39 por cada 1000 llamadas. Las llamadas fallidas y los resultados vacíos no se cobran.
¿Tengo que iniciar sesión en Instagram para traducir un texto?
No. Pon tu clave de API de EveryInfra en la cabecera Authorization: Bearer; no necesitas iniciar sesión en Instagram ni un token de acceso.
¿En qué se diferencian post_translation y comment_translations?
post_translation traduce el texto de una publicación; su entrada es el url o media_id de la publicación. comment_translations traduce comentarios elegidos de una publicación; pide url y comment_ids.
Capacidades de Instagram relacionadas
La misma clave de API de EveryInfra sirve para las demás capacidades de Instagram, por ejemplo comment_translations, que traduce comentarios.
- Detalles de la publicación
post$0.56 por cada 1000 llamadasProcesa una o varias URL enurlsy devuelve publicaciones de Instagram con autor, texto, tipo de medio y métricas visibles. - Detalles
profile$0.56 por cada 1000 llamadasResuelve unusernamede Instagram y devuelve nombre, biografía, contadores y señales públicas de cuenta. - Análisis de la cuenta
persona$0.56 por cada 1000 llamadasConsulta medianteusernamelos mismos campos públicos queprofiley añade un objetopersonaescrito por IA con sector, nicho, autenticidad y resumen. - Publicaciones del usuario
user_posts$0.56 por cada 1000 llamadasObtiene publicaciones públicas delusername, con URL, texto, formato y contadores por pieza. - Descubrimiento de contenido
discover$0.56 por cada 1000 llamadasDescubre publicaciones porkeywordy permite elegirresults_type. - Comentarios
comments$0.79 por cada 1000 llamadasLee comentarios de laurlde una publicación, con autor, likes, respuestas y fecha cuando existen. - Reels
reels$1.19 por cada 1000 llamadasConsulta Reels asociados ausernamey devuelve descripción, título, reproducciones, duración y texto cuando está disponible. - Contenido por hashtag
hashtag$0.56 por cada 1000 llamadasBusca contenido delhashtag, aceptando alias compatibles de etiqueta o palabra, y distingue posts de Reels medianteresults_type. - Seguidores
followers$0.56 por cada 1000 llamadasObtiene parausernamecontadores y señales de conexión agregadas. - Lista de seguidores
followers_list$0.56 por cada 1000 llamadasEnumera cuentas seguidoras delusernamecon relación y perfil público cuando están disponibles. - Lista de cuentas seguidas
following_list$0.56 por cada 1000 llamadasLista cuentas seguidas por elusername, conservando privacidad y verificación visibles. - Búsqueda de cuentas
user_search$4.81 por cada 1000 llamadasBusca cuentas de Instagram porkeyword, en el orden en que la búsqueda de Instagram las clasifica para esa palabra (rankdesde 1). - Búsqueda de Reels
reels_search$7.19 por cada 1000 llamadasBusca Reels de Instagram porkeyword, por ejemplo coffee. - Cuentas similares
similar_profiles$8.81 por cada 1000 llamadasLista las cuentas que Instagram sugiere como similares a unusername, por ejemplo nasa, ordenadas por seguidores (rankdesde 1). - Publicaciones etiquetadas
tagged_posts$7.44 por cada 1000 llamadasLista publicaciones públicas de otras cuentas que etiquetan a unusername(también vale la URL del perfil o el ID numérico). - Historias
stories$1.5 por cada 1000 llamadasDevuelve las historias que una cuenta de Instagram tiene activas ahora, a partir de su usuario. - Historias destacadas
highlights$1.6 por cada 1000 llamadasLista las historias destacadas de un perfil de Instagram. - Respuestas a comentarios
comment_replies$0.88 por cada 1000 llamadasLee las respuestas a un comentario de una publicación o Reel de Instagram, con el enlace de la publicación y eliddel comentario que devuelvecomments. - Cuentas que dieron me gusta
likers$1.32 por cada 1000 llamadasLista las cuentas que dieron «me gusta» a una publicación o Reel de Instagram, a partir de suurl. - Publicaciones de un lugar
location_posts$0.56 por cada 1000 llamadasLista las publicaciones etiquetadas en un lugar de Instagram, a partir delocation_id(eliddelocation_detailen una publicación, o el enlace de la página del lugar). - Reels con una misma música
audio_posts$0.56 por cada 1000 llamadasLista los Reels de Instagram que usan una misma música, a partir deaudio_id(elaudio_iddemusicen una publicación, o el enlace de la página del audio). - Exploración
explore$0.56 por cada 1000 llamadasLee una página de las publicaciones que Instagram recomienda en Explore; no necesita ningún parámetro. - Estadísticas de interacción
engagement$0.56 por cada 1000 llamadasCalcula la interacción de una cuenta de Instagram a partir de sus últimas publicaciones, conusername. - Perfil por ID numérico
profile_by_id$0.56 por cada 1000 llamadasConsulta una cuenta de Instagram a partir de suuser_idnumérico. - Acerca de esta cuenta
user_about$0.56 por cada 1000 llamadasLee el panel «Información sobre esta cuenta» de un perfil de Instagram a partir deusername: el mes en que se unió (joined_at), elcountry, cuántas veces cambió de nombre de usuario (former_usernames_count) y cuándo se verificó. - Datos de un lugar
location_info$0.56 por cada 1000 llamadasLee un lugar de Instagram a partir de sulocation_id: nombre, categoría, coordenadas (lat,lng), dirección cuando figura ypost_count. - Reconocimiento de enlaces
resolve_links$0.56 por cada 1000 llamadasConvierte la referencia a una publicación que pasas entext(enlace, shortcode o ID numérico) en sus tres formas:shortcode,media_idyurl. - Código para insertar una publicación
oembed$0.56 por cada 1000 llamadasObtén los datos oEmbed y el código para insertar una publicación o Reel de Instagram a partir de suurl: los mismos campos que el oEmbed oficial de Instagram, conhtmllisto para pegar en una página web. - Lugares cercanos
location_nearby$0.56 por cada 1000 llamadasLista los lugares que Instagram muestra cerca de un lugar, a partir de sulocation_id: unas 20 filas por llamada, sin página siguiente. - Búsqueda de hashtags
hashtag_search$0.56 por cada 1000 llamadasBusca hashtags de Instagram para unakeyword: los que sugiere el cuadro de búsqueda, con elpost_countde cada uno, de unos pocos a unos 15 por llamada, sin página siguiente. - Historias de un destacado
highlight_stories$0.56 por cada 1000 llamadasLee todas las historias de un destacado de Instagram conhighlight_id(eliddehighlightso un enlace del destacado): hasta 100 historias en una llamada, con los enlaces de los medios,posted_atyduration_seconds. - Traducción de comentarios
comment_translations$6.39 por cada 1000 llamadasTraduce hasta 10 comentarios de una publicación de Instagram, con laurlde la publicación ycomment_ids, altarget_language(por defectoen). - Reels recomendados
recommended_reels$1.18 por cada 1000 llamadasLee los Reels que Instagram recomienda en su página de Reels, 10 por página; no necesita parámetros. - Republicaciones de una cuenta
user_reposts$0.56 por cada 1000 llamadasLista las publicaciones y Reels que una cuenta de Instagram republicó en su perfil, conusername, 12 por página. - Ciudades de un país
location_cities$0.56 por cada 1000 llamadasLista las ciudades del directorio de lugares de Instagram para uncountry_code, 96 por página. - Lugares de una ciudad
city_locations$0.56 por cada 1000 llamadasLista los lugares del directorio de lugares de Instagram para una ciudad, concity_id, 96 por página. - Perfiles en lote
profiles_batch$0.56 por cada 1000 llamadasConsulta hasta 20 cuentas de Instagram a la vez conusernames, cada una como nombre de usuario (por ejemplonatgeo) o enlace de perfil.