instagram/
posts

Recopile las publicaciones públicas de Instagram de uno o más nombres de usuario, con descripciones normalizadas, datos del autor, medios, hashtags, menciones, marcas de tiempo e interacción visible.

Instagram Posts API

Publicaciones
Metadatos de medios
Datos públicos
0.34 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Instagram Posts

Las publicaciones de Instagram son contenidos del feed con descripciones, contexto del autor, imágenes o videos, marcas de tiempo, hashtags, menciones e interacción visible. Estas señales de contenido sirven para investigar creadores de contenido, revisar campañas, analizar medios y elaborar informes históricos.

Funcionalidades de la Instagram Posts API

  • Recopilación de publicaciones por nombre de usuarioRecopile las publicaciones públicas de Instagram de uno o más nombres de usuario con una única estructura de respuesta normalizada.
  • Referencias y dimensiones de los mediosDevuelve las referencias públicas de medios y miniaturas, las dimensiones y la duración del video en campos de medios normalizados.
  • Registros de fotos y videosNormaliza las publicaciones públicas de fotos y videos en la misma estructura de respuesta.
  • Campos de contenido e interacciónIncluye el texto de la descripción, la identidad del autor, la hora de publicación, las métricas visibles, los hashtags y las menciones en cada registro de publicación.
  • Límite de datos públicosMantiene fuera de la respuesta el contenido privado, eliminado, restringido o que requiere iniciar sesión.

Parámetros de la Instagram Posts API

ParámetrosObligatorioDescripción
usernamesObligatorioNombres de usuario públicos de Instagram sin @, separados por comas o saltos de línea.
results_limitOpcionalCantidad máxima de registros que debe solicitar la tarea de recopilación. Debe ser un entero positivo.

Cómo usar la Instagram Posts API

Envíe nombres de usuario públicos como una tarea asíncrona, consulte su ID de tarea y luego lea los registros de publicaciones normalizados con paginación por cursor.

  1. Prepare uno o más nombres de usuario públicos de Instagram sin @.
  2. Envíe usernames y un results_limit opcional por POST a /v1/instagram/posts.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. Lea /v1/tasks/{task_id}?limit=50 y siga results.next_cursor cuando haya más registros.
curl -X POST "https://api.socq.ai/v1/instagram/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Casos de uso de la Instagram Posts API

  • Recopilación de publicaciones de perfiles: Recopile las publicaciones públicas de nombres de usuario de Instagram seleccionados en registros normalizados, con referencias de medios e identificadores estables.
  • Investigación de contenido: Recopile descripciones, marcas de tiempo, hashtags y contadores de interacción visibles de publicaciones públicas para los equipos de investigación o analítica.
  • Flujos de archivo: Almacene los metadatos de publicaciones públicas, las referencias de medios, el contexto del autor, las URL de origen y las horas de recopilación para colas de revisión, sistemas de informes o registros internos.
  • Control de calidad de campañas: Revise las publicaciones públicas devueltas para nombres de usuario de creadores o marcas antes de unir los registros seleccionados con los datos de la campaña.
  • Enriquecimiento del contenido de perfiles: Una los IDs de publicación, los datos del autor, las descripciones, las referencias de medios y las métricas visibles con registros existentes de perfiles o campañas.

Consejos de expertos para la Instagram Posts API

  • Envíe los nombres de usuario sin el prefijo @ y mantenga los lotes pequeños mientras valida un flujo de trabajo nuevo.
  • Prevea que algunos registros públicos omitan referencias de medios, contadores o marcas de tiempo, según la disponibilidad en el origen.
  • Aplique reintentos conservadores con retroceso ante respuestas 429, de desafío o de bloqueo temporal, en lugar de reintentar de forma agresiva.
  • Use Reels API para recopilar los Reels de un perfil, Search API para el descubrimiento y Comments API cuando importen los hilos de comentarios públicos.
  • Evite diseñar flujos de trabajo en torno a cuentas privadas, historias, historias destacadas o campos que requieren iniciar sesión.

Además de la Instagram Posts API, use estas APIs cuando necesite otro tipo de datos públicos de Instagram.

  • Instagram Reels API — Recolecta Reels públicos, contenido multimedia, audio, hashtags, menciones e interacción por nombre de usuario.
  • Instagram Comments API — Recolecta comentarios públicos, autores, marcas de tiempo, Me gusta y respuestas desde URLs de publicaciones.
  • Instagram Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, enlaces, indicadores de cuenta, categorías y conteos visibles.
  • Instagram Tagged Posts API — Recolecta publicaciones públicas que etiquetan a los perfiles seleccionados, con autores, contenido multimedia, menciones, contexto de los usuarios etiquetados e interacción.
  • Instagram Transcript API — Extrae el texto de la transcripción, el idioma, el formato, las URLs de origen y los shortcodes desde URLs de publicaciones o Reels públicos.
  • Instagram Post Info API — Consulta URLs conocidas de publicaciones, Reels o IGTV antiguos públicos, con descripciones, identidad del autor, contenido multimedia, marcas de tiempo, interacción visible y contexto de la entrada.

Explorar otras plataformas

Combine los datos de Instagram con datos públicos de otras plataformas sociales compatibles.

Instagram Posts API — FAQ

Instagram Posts API recopila las publicaciones de acceso público de uno o más nombres de usuario de Instagram. Devuelve descripciones normalizadas, datos del autor, referencias de medios, hashtags, menciones, marcas de tiempo y conteos de interacción visibles.

El endpoint actual acepta uno o más nombres de usuario públicos. No acepta la URL ni el shortcode de una publicación individual como entrada de la solicitud.

Sí. Cuando los resultados públicos exponen datos de medios, los elementos normalizados pueden incluir URL de imágenes o videos, miniaturas, dimensiones y duración del video.

Los campos habituales incluyen el ID de la publicación, el shortcode, la URL canónica, el autor, la descripción, la hora de publicación, las métricas visibles, las referencias de medios, los hashtags, las menciones y la hora de recopilación.

No. Las publicaciones privadas, eliminadas, restringidas o que requieren iniciar sesión pueden devolver datos limitados o ningún registro, porque el endpoint solo recopila resultados de acceso público.

Puede devolver referencias públicas de medios cuando los resultados públicos las exponen. Aun así, los clientes deben manejar URL de medios ausentes, que vencen o restringidas, porque la disponibilidad puede variar según el tipo de publicación y la respuesta del origen.

Use frecuencias de solicitud conservadoras, lotes de nombres de usuario más pequeños, retroceso tras respuestas 429 o de desafío, y reintente más tarde cuando una fuente pública no esté disponible temporalmente.