instagram/
reels

Recopile los Reels públicos de Instagram de uno o más nombres de usuario, con descripciones normalizadas, medios, duración, audio, hashtags, menciones e interacción visible.

Instagram Reels API

Reels
Datos públicos
Metadatos de medios
0.52 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 Reels

Los Reels de Instagram son publicaciones de video corto con descripciones, contexto del creador, medios, audio, duración, hashtags, menciones, conteo de reproducciones e interacción visible. Estas señales creativas y de rendimiento sirven para investigar formatos, comparar creadores de contenido, revisar campañas y analizar tendencias.

Funcionalidades de la Instagram Reels API

  • Recopilación de Reels por perfilRecopile los Reels públicos de uno o más nombres de usuario de Instagram con una única estructura de respuesta normalizada.
  • Campos de contenido, medios e interacciónDevuelve descripciones, marcas de tiempo, conteo de reproducciones, Me gusta, comentarios, veces compartido, duración, miniaturas, referencias de video, hashtags, menciones y metadatos del audio.
  • Tope de resultados solicitadosUse results_limit para limitar la cantidad de Reels solicitados en cada solicitud.
  • Límite de datos públicosMantiene fuera del alcance de los resultados los Reels privados, restringidos, eliminados o que requieren iniciar sesión.

Parámetros de la Instagram Reels 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 Reels API

Envíe nombres de usuario públicos como una tarea asíncrona, consulte su ID de tarea y luego lea los registros de Reels 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/reels.
  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/reels" \
  -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 Reels API

  • Investigación del rendimiento de Reels: Recopile conteos públicos de reproducciones, Me gusta, comentarios, veces compartido, descripciones y marcas de tiempo para comparar el rendimiento del video corto.
  • Descubrimiento de creadores: Revise los Reels públicos de perfiles relevantes y luego enriquezca a los creadores de contenido seleccionados con las API de perfiles o de cronología de publicaciones.
  • Monitoreo de campañas: Siga los Reels públicos vinculados a un lanzamiento, un hashtag, una tendencia musical, un brief para creadores o un formato de contenido recurrente.
  • Flujos de archivo de medios: Almacene los metadatos de Reels públicos, las miniaturas, las URL de origen, la duración, los detalles del audio y las horas de recopilación para sistemas de revisión o de informes.
  • Análisis de audio: Use los campos públicos de audio, cuando estén disponibles, para apoyar la agrupación por temas, la revisión de moderación o el análisis creativo.

Consejos de expertos para la Instagram Reels API

  • Guarde IDs de Reel estables, shortcodes, URL e IDs de tarea para poder reintentar y auditar los trabajos de recopilación.
  • Use valores conservadores de results_limit y lógica de retroceso al recopilar listas extensas de Reels de perfiles públicos.
  • Prevea que algunos Reels públicos omitan contadores, referencias de video o detalles del audio, según la disponibilidad en el origen.
  • Use Search API para descubrir perfiles y Reels API para los Reels públicos de los nombres de usuario seleccionados.
  • Evite diseñar flujos de trabajo en torno a cuentas privadas, Reels restringidos o campos que requieren iniciar sesión.

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

  • Instagram Posts API — Recolecta publicaciones públicas, contenido multimedia, hashtags, menciones, marcas de tiempo 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 Audio Reels API — Recolecta Reels públicos a partir de un ID numérico de audio conocido, con descripciones, creadores, contenido multimedia, marcas de tiempo, interacción visible y contexto del audio de origen.

Explorar otras plataformas

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

Instagram Reels API — FAQ

Instagram Reels API recopila los Reels de acceso público de uno o más nombres de usuario de Instagram. Devuelve descripciones normalizadas, datos del autor, referencias de medios, duración, audio, hashtags, menciones y conteos de interacción visibles.

Los campos habituales incluyen el ID del Reel, el shortcode, la URL, el autor, la descripción, la marca de tiempo, las métricas visibles, las referencias de medios, la duración, los hashtags, las menciones, los metadatos del audio y la hora de recopilación.

El endpoint actual acepta uno o más nombres de usuario públicos de Instagram. No acepta la URL ni el shortcode de un Reel individual como entrada de la solicitud.

No. Los Reels privados, restringidos, eliminados 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 video cuando los resultados públicos del Reel exponen esas URL. Algunos Reels solo exponen metadatos o miniaturas, por lo que los clientes deben manejar campos de medios ausentes.

Use frecuencias de solicitud conservadoras, páginas más pequeñas, continuación basada en cursor y retroceso tras respuestas 429 o de presión similar. Evite extraer repetidamente un mismo perfil con un volumen alto.

Sí, cuando los resultados públicos exponen datos de audio. El objeto de audio normalizado puede incluir un ID, un título, un artista y una URL.