facebook/
reels

Recopile los Reels públicos de Facebook a partir de URL de perfiles o páginas, con descripciones, contexto del autor, interacción, metadatos de video y enlaces de origen en registros normalizados.

Facebook Reels API

Reels de perfiles
Metadatos de video
Datos públicos
0.7 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

Facebook Reels

Los Reels de Facebook son videos públicos de formato corto en los feeds de perfiles o páginas, con descripciones, contexto del autor, metadatos de reproducción, marcas de tiempo e interacción visible. Estos registros sirven para inventariar contenido, investigar videos cortos, monitorear feeds y hacer análisis comparativos.

Funcionalidades de la Facebook Reels API

  • Feeds de Reels de varios perfilesRecopile registros de Reels públicos de una o más URL de perfiles o páginas de Facebook, aplicando el límite solicitado a cada entrada y conservando extra.input_url para la atribución.
  • Medios de video normalizadosDevuelve las URL de los videos, las miniaturas, las dimensiones y los metadatos de duración, junto con los ID de los Reels y los enlaces de origen públicos.
  • Contexto del creador y de la interacciónConserva las descripciones, el contexto público del autor sin procesar, los Me gusta, comentarios, vistas, reproducciones y veces compartido visibles, y las horas de publicación de cada Reel normalizado.
  • Recorrido estable del feedSigue los cursores propios de cada perfil y elimina los Reels duplicados por ID, ID de publicación o URL antes de llegar al límite por entrada.

Parámetros de la Facebook Reels API

ParámetrosObligatorioDescripción
urlsObligatorioURL de perfiles o páginas públicos de Facebook, separadas por comas o saltos de línea.
results_limitOpcionalNúmero máximo de Reels por recopilar para cada URL de entrada, de 20 a 2,000; el valor predeterminado es 100.

Cómo usar la Facebook Reels API

Envíe URL de perfiles o páginas públicos como una tarea asíncrona, consulte su ID de tarea y lea los registros de Reels normalizados mediante paginación por cursor de resultados.

  1. Prepare una o más URL de perfiles o páginas públicos de Facebook que expongan feeds de Reels.
  2. Envíe urls, con un results_limit opcional, por POST a /v1/facebook/reels.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
  4. Lea /v1/tasks/{task_id}?limit=50 y pase results.next_cursor cuando existan más Reels guardados.
curl -X POST "https://api.socq.ai/v1/facebook/reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'

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

Casos de uso de la Facebook Reels API

  • Inventario de Reels de un perfil: Organice los ID de los Reels, los enlaces de origen, las descripciones, las referencias a video, las marcas de tiempo y extra.input_url en un índice de contenido de un perfil concreto.
  • Investigación del formato de video corto: Compare la duración, las dimensiones, las miniaturas, las descripciones y la interacción visible para estudiar cómo se presentan y cómo se reciben los Reels públicos.
  • Monitoreo de feeds de Reels: Repita las recopilaciones de URL de perfiles o páginas seleccionados y use la identidad estable del Reel junto con la hora de publicación para detectar registros recién expuestos.

Consejos de expertos para la Facebook Reels API

  • Use URL de perfiles y páginas de facebook.com, www.facebook.com o m.facebook.com que expongan un feed público de Reels; la validación del host por sí sola no garantiza que el recurso de destino sea el adecuado.
  • Defina results_limit teniendo en cuenta el número de URL de entrada, porque el límite de 20 a 2,000 se aplica de forma independiente a cada URL.
  • Al combinar ejecuciones repetidas, deduplique por ID del Reel, ID de la publicación o URL junto con extra.input_url para conservar el perfil de origen correcto.
  • Trate las descripciones, los campos del autor, las métricas, las marcas de tiempo y los metadatos de medios como opcionales, y verifique que media contenga una URL de video antes de reproducirlo o descargarlo.
  • Cuando necesite el texto hablado, envíe la URL del Reel conocido a Facebook Video Transcript API en lugar de esperar una transcripción en los registros de Reels.

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

  • Facebook Posts API — Recolecta publicaciones públicas, contenido multimedia, reacciones, comentarios y veces compartido desde URLs de Facebook compatibles.
  • Facebook Comments API — Recolecta comentarios públicos, autores, interacción, contenido multimedia y enlaces de origen desde URLs de publicaciones.
  • Facebook Video Transcript API — Extrae el texto de transcripción disponible y su formato desde URLs conocidas de videos o Reels públicos.
  • Facebook Group Posts API — Recolecta publicaciones públicas desde URLs de grupos de Facebook con orden seleccionable, límites por grupo, contexto del autor, videos e interacción visible.
  • Facebook Ad Transcript API — Extrae el texto hablado disponible, el idioma, el formato y el contexto de origen desde URLs de la Facebook Ad Library.
  • Facebook Profiles API — Consulta perfiles o páginas públicos a partir de URLs conocidas de Facebook con identidad, biografía, avatar, contadores visibles y contexto de la entrada.

Explorar otras plataformas

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

Facebook Reels API — FAQ

Facebook Reels API es una interfaz programática que recopila registros de videos cortos del feed público de Reels de un perfil o una página de Facebook específicos, lo que simplifica el inventario masivo y la observación continua. Los equipos de contenido pueden usar esos registros para monitorear cuentas y hacer investigación comparativa, pero solo se cubren los Reels accesibles a través del feed público del destino.

Use perfiles o páginas públicos en facebook.com, www.facebook.com o m.facebook.com. La validación comprueba el host, por lo que un recurso de Facebook distinto aún puede no devolver un feed de Reels adecuado.

Un registro puede incluir el ID del Reel, la URL canónica, el texto de la descripción, el contexto público del autor sin procesar, las métricas visibles, la URL del video, la miniatura, las dimensiones, la duración, created_at, collected_at y extra.input_url.

No. Los registros de Reels contienen descripciones y metadatos de video, mientras que el texto hablado disponible lo maneja la Facebook Video Transcript API específica para las URL de Reels compatibles.

No. Este endpoint lee los feeds de Reels de URL públicas de perfiles o páginas conocidos; no ofrece búsqueda por palabra clave, descubrimiento de tendencias ni descubrimiento basado en audio.

Defina results_limit de 20 a 2,000; el valor predeterminado es 100. El límite se aplica por separado a cada URL enviada.

No. La recopilación se detiene en el límite por URL, al final del feed disponible o tras 100 páginas del feed, y pueden faltar los Reels privados, restringidos, eliminados, que requieren iniciar sesión o que no estén disponibles de otro modo.

Cada registro de Reel guardado cuesta 0.7 créditos, sin cargo base por tarea. Las estimaciones multiplican el límite de resultados por URL por el número de URL enviadas.