Documentación del endpoint de perfil de Instagram

Información de la cuenta de Instagram por ID de usuario — documentación de la API

Usa este endpoint cuando ya conozcas el ID de usuario de Instagram y necesites la información pública «Sobre esta cuenta» antes de abrir flujos más pesados de perfil, contenido o relaciones sociales.

Es un punto de entrada práctico para equipos que resuelven la identidad de creadores, enriquecen registros de cuentas, revisan el contexto del perfil público o validan si una cuenta de Instagram conocida debe entrar en un flujo de monitorización más amplio.

Método GET
Entidad Perfil
Versiones 2
Qué hace este endpoint

Qué puedes construir con este método de API

Revisa primero el resultado y los flujos habituales y luego pasa a los parámetros y a un ejemplo de solicitud funcional.

En qué te ayuda este endpoint

Esta documentación explica para qué sirve el método de API, en qué se diferencian V1 y V2, qué parámetros de solicitud necesitas y cómo es la estructura de la respuesta cuando hay un ejemplo de verificación en vivo.

Cuándo usarlo

Es un punto de entrada práctico para equipos que resuelven la identidad de creadores, enriquecen registros de cuentas, revisan el contexto del perfil público o validan si una cuenta de Instagram conocida debe entrar en un flujo de monitorización más amplio.

Casos de uso habituales

Enriquecimiento de cuentas

Añade el contexto público «Sobre esta cuenta» a ID de usuario de Instagram conocidos antes de ampliar a publicaciones, comentarios o recopilación de relaciones sociales.

Operaciones con creadores

Valida la información pública de la cuenta en la incorporación de creadores, la revisión de listas de candidatos y los flujos internos de control de calidad que ya guardan ID de usuario de Instagram.

Flujos de confianza y revisión

Revisa el comportamiento del método y la forma de la respuesta antes de conectar el endpoint a controles de moderación, seguridad de marca o cumplimiento.

Versiones disponibles

Versión de la respuesta

Ambas versiones resuelven la misma tarea y aceptan los mismos parámetros. Usa el selector para comparar la estructura de la respuesta y elegir la versión que espera tu cliente.

Versión de la respuesta V2

Cambia de versión en esta página para comparar las estructuras de respuesta manteniendo la misma URL de documentación.

Qué se mantiene igual

La autenticación, los parámetros obligatorios y la forma de la solicitud son iguales en V1 y V2. En la práctica, eliges la versión al construir la ruta del endpoint y al interpretar la respuesta.

Qué cambia entre versiones

La diferencia principal está en el envoltorio de la respuesta. Usa V2 para integraciones nuevas y mantén V1 solo cuando necesites compatibilidad con un contrato de cliente existente.

Cómo usarlo

Cómo llamar al método

Usa la misma cabecera de clave de API y los mismos parámetros de consulta en ambas versiones. Esta documentación muestra primero el conjunto de parámetros común y después las rutas y fragmentos de código de cada versión.

Parámetros de entrada

Parámetros comunes
Parámetro Obligatorio Tipo Ejemplo Descripción
user_id Sí str 25025320 ID numérico del usuario en la plataforma seleccionada.

Ruta de solicitud por versión

V2

Elige una versión cuando copies la ruta exacta del endpoint, la URL de ejemplo y el fragmento de código. La lista de parámetros de arriba no cambia.

GET /api/v2/instagram.com/profile/about-account-by-user-id

Formato normalizado

Ejemplos de código

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/instagram.com/profile/about-account-by-user-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'user_id=25025320'
Ejemplo de respuesta

Respuesta en vivo por versión

La vista previa conserva los campos clave y los primeros elementos de la colección para que puedas revisar rápidamente la forma de la respuesta. Al cambiar de versión cambia el formato del JSON.

Ejemplo de respuesta

V2 JSON de respuesta

Marcador de posición

Todavía no hay un ejemplo de verificación en vivo para V2. Este marcador mantiene visible el envoltorio de respuesta estándar hasta que haya un ejemplo verificado.

{
  "success": true,
  "status": "ok",
  "data": {}
}
Qué hacer después

Continúa la evaluación

Usa esta documentación como primer punto de decisión y luego revisa los precios, la cobertura de la plataforma y las reglas de integración antes de conectar el endpoint para un uso recurrente.

Abre la página de la plataforma Instagram

Compara entidades cercanas, grupos de métodos de API y documentación relacionada antes de implementar.

Abrir la página de la plataforma

Compara los precios de los métodos de API

Comprueba dónde se sitúa este método en la tabla pública de precios antes de escalar el uso.

Ver precios

Revisa las reglas de integración

Usa la documentación inicial para confirmar la autenticación, las versiones, los reintentos y las diferencias entre prueba y producción.

Abrir la documentación
Preguntas frecuentes

Preguntas que los equipos hacen antes de implementar

Usa estas respuestas para decidir si este método de API encaja con tu flujo, tu elección de versión y tu plan de despliegue.

¿Cuándo debo usar este método de API en lugar de un endpoint de perfil de Instagram más amplio?

Úsalo cuando ya tengas un ID numérico de usuario de Instagram y quieras primero la información pública «Sobre esta cuenta». Los métodos de perfil más amplios encajan mejor cuando todavía necesitas resolver la identidad u otras superficies de la cuenta.

¿Las integraciones nuevas deben empezar con V1 o V2 en esta página de documentación?

Usa V2 por defecto en las integraciones de producto nuevas porque mantiene estable la estructura de respuesta normalizada. Mantén V1 solo por compatibilidad con clientes que todavía dependen de la carga original con la forma de la plataforma.

¿Esta página muestra siempre un ejemplo de respuesta verificado?

La sección de respuesta siempre intenta cargar un ejemplo JSON verificado. Si todavía no existe un ejemplo verificado para una versión, la página muestra un envoltorio estándar de marcador para que la estructura de la respuesta siga visible.