API de Reconocimiento de enlaces de Instagram

Convierte el enlace de una publicación, su shortcode o su media_id numérico en los otros dos. Basta con dar uno de los tres, por $0.56 por cada 1000 llamadas.

  • La entrada es una de tres: enlace, shortcode o media_id
  • Solo convierte y no comprueba que la publicación siga existiendo
  • La respuesta trae shortcode, media_id y url

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "resolve_links",
      "params": {
        "text": "https://www.instagram.com/p/DbYmqpplO_N/"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "shortcode": "DbYmqpplO_N",
        "media_id": "3952078729724096461",
        …
      }
    }
  3. 3Campos

    shortcodemedia_id
    DbYmqpplO_N3952078729724096461
  4. 4CSV

    instagram-resolve_links-sample.csv shortcode,media_id,url,platform

La solicitud lleva en text un enlace de publicación, un shortcode o un identificador numérico y devuelve un objeto JSON con shortcode, media_id y url, 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. Tus llamadas devuelven los campos de la referencia de campos.

shortcodemedia_idurlplatform
DbYmqpplO_N3952078729724096461https://www.instagram.com/p/DbYmqpplO_N/instagram

Casos de uso

  • Escribe las publicaciones de una sola forma

    Una publicación tiene tres formas: enlace, shortcode e identificador numérico. Conviértelas y elimina duplicados con shortcode o media_id.

  • Convierte un shortcode en enlace

    Si solo tienes un shortcode, pásalo y recibe el url completo.

  • Comprueba que un enlace y un identificador coinciden

    Pasa el enlace y compara el media_id devuelto para confirmar que dos registros describen la misma publicación.

  • Limpia una lista recopilada

    Si las publicaciones de una lista vienen en formas distintas, conviértelas una por una a la misma forma antes del siguiente paso.

Instagram Graph API frente a EveryInfra

Comparación entre la Graph API oficial de Instagram y resolve_links de EveryInfra: acceso.

AspectoInstagram Graph APIEveryInfra
Acceso necesarioToken de acceso: "Required. App user’s User access token."Una clave de API de EveryInfra en la cabecera Authorization: Bearer. No hace falta iniciar sesión en Instagram ni un token de acceso de Instagram.

La cita procede de la documentación para desarrolladores de Meta (página IG User), comprobada el 2026-11-22. Esta fila compara solo el acceso. Fuentes oficiales: IG User (actualizada el 2026-04-22)

Límites y detalles a tener en cuenta

  • text es obligatorio: el enlace de una publicación, un shortcode o el identificador numérico de una publicación. Da uno de los tres.
  • Solo convierte. No comprueba que la publicación siga existiendo.
  • La respuesta trae tres datos: shortcode, media_id y url.
  • Una llamada convierte una publicación y devuelve un objeto.

Precios

Cada llamada cuesta $0.000556 y convierte una publicación. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$5.56
100,000$55.56
1,000,000$555.56

Los totales usan el precio de lista por llamada.

Ejemplos de código

#
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": "resolve_links",
  "params": {
    "text": "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 resolve_links, y copia la página o ábrela como Markdown para un asistente de IA.

POST

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Instagram: Reconocimiento de enlaces (instagram/resolve_links).

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 resolve_links, y los parámetros dentro de params.
- Parámetros obligatorios:
  - text: Un enlace, shortcode o ID numérico de una publicación, como https://www.instagram.com/p/<shortcode>/.
- Devuelve un objeto. Campos principales: shortcode (Shortcode de la publicación: la parte d…), media_id (ID numérico de la publicación), url.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "instagram",
  "action": "resolve_links",
  "params": {
    "text": "https://www.instagram.com/p/DbYmqpplO_N/"
  }
}
- Precio: $0.56 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

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-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.
platformbodystringSíinstagramIdentificador de la plataforma, valor fijo.
actionbodystringSíresolve_linksIdentificador de la capacidad, valor fijo.
textbody.paramsstringSí-Un enlace, shortcode o ID numérico de una publicación, como https://www.instagram.com/p/<shortcode>/.

Ejemplo de respuesta

#
Obtenida el 21 de noviembre de 2026, 07:18 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "instagram",  "action": "resolve_links",  "results": {    "shortcode": "DbYmqpplO_N",    "media_id": "3952078729724096461",    "url": "https://www.instagram.com/p/DbYmqpplO_N/",    "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.

CampoSignificado
shortcodeShortcode de la publicación: la parte del enlace después de /p/ o /reel/.
media_idID numérico de la publicación. oembed lo da como IDpublicación_IDautor.
urlEnlace al registro en la plataforma.
platformIdentificador 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.

Errores

Preguntas frecuentes

¿Cómo convierto entre el enlace de una publicación de Instagram y su identificador?

Pon el enlace, el shortcode o el identificador numérico en text. La respuesta trae shortcode, media_id y url.

¿La conversión comprueba que la publicación siga existiendo?

No. Solo convierte y no comprueba que la publicación siga existiendo.

¿Cuánto cuesta resolver un enlace?

Se cobra por llamada: $0.000556 cada una, o $0.56 por cada 1000 llamadas. Las llamadas fallidas y los resultados vacíos no se cobran.

¿Tengo que iniciar sesión en Instagram para convertir el identificador de una publicación?

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 shortcode y media_id?

shortcode es la parte del enlace de la publicación que sigue a /p/ o /reel/. media_id es el identificador numérico de la publicación.

La misma clave de API de EveryInfra sirve para las demás capacidades de Instagram, por ejemplo post, que lee una publicación a partir de su enlace.

Google Analytics solo si aceptas. Privacidad