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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL de perfiles o páginas públicos de Facebook, separadas por comas o saltos de línea. |
results_limit | Opcional | Nú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.
- Prepare una o más URL de perfiles o páginas públicos de Facebook que expongan feeds de Reels.
- Envíe urls, con un results_limit opcional, por POST a /v1/facebook/reels.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
- 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.
APIs relacionadas
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.