Facebook Posts
Las publicaciones de Facebook son novedades públicas de páginas, perfiles o grupos, con texto, enlaces, medios, contexto del autor, marcas de tiempo e interacción visible. Estas señales de contenido y de interacción sirven para monitorear campañas, investigar contenido editorial, analizar audiencias y elaborar informes.
Funcionalidades de la Facebook Posts API
- URL públicas compatiblesRecopile publicaciones de URL públicas de páginas, perfiles, grupos o publicaciones de Facebook con una única estructura de respuesta normalizada.
- Campos de contenido y mediosDevuelve el texto de la publicación, los ID de publicación, el contexto del autor, las marcas de tiempo, los enlaces, los medios, las veces compartido, los conteos de comentarios y los conteos visibles de reacciones en campos normalizados.
- Desglose de reaccionesOfrece el desglose visible de reacciones: me gusta, me encanta, me asombra, me importa, me entristece, me enoja y me divierte.
- Tope de resultados solicitadoAcepta una o más URL compatibles y usa results_limit para limitar los registros de publicaciones solicitados.
- Límite de datos públicosDeja fuera de la respuesta el contenido privado, restringido, que requiere iniciar sesión o que ya fue eliminado.
Parámetros de la Facebook Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL públicas de páginas, perfiles, grupos o publicaciones de Facebook, separadas por comas o saltos de línea. |
results_limit | Opcional | Número máximo de registros que la tarea de recopilación debe solicitar. Debe ser un entero positivo. |
Cómo usar la Facebook Posts API
Envíe una tarea de recopilación asíncrona, consulte su ID de tarea y lea los registros de publicaciones públicas normalizados con paginación por cursor.
- Prepare una o más URL públicas de páginas, perfiles, grupos o publicaciones de Facebook.
- Envíe urls y, de forma opcional, results_limit por POST a /v1/facebook/posts.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- Lea /v1/tasks/{task_id}?limit=50 y siga results.next_cursor cuando existan más registros.
curl -X POST "https://api.socq.ai/v1/facebook/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/cern"],"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 Facebook Posts API
- Monitoreo de páginas públicas: Recopile publicaciones públicas, marcas de tiempo, enlaces, referencias a medios y contadores visibles de las páginas de Facebook que su producto monitorea.
- Informes de campañas y marcas: Normalice el texto de las publicaciones, las reacciones, los comentarios, las veces compartido y los campos de medios antes de enviar los datos de campaña a paneles o herramientas de BI.
- Investigación de contenido: Analice descripciones públicas, temas de publicaciones, enlaces, imágenes, videos y patrones de interacción en torno a una marca, un evento o un tema.
- Flujos de escucha social: Dirija las señales de publicaciones públicas a colas de revisión, sistemas de alertas o herramientas internas de investigación sin mantener parsers de páginas frágiles.
- Archivo de publicaciones y pistas de auditoría: Almacene los ID de publicación normalizados, las URL de origen, las marcas de tiempo, los contadores visibles y las horas de recopilación para contar con archivos e informes reproducibles.
Consejos de expertos para la Facebook Posts API
- Comience con lotes pequeños de páginas públicas y aumente el límite solo cuando sus reintentos y su retroceso exponencial funcionen correctamente.
- Almacene los ID de publicación normalizados, las URL, los ID de tarea y next_cursor para poder retomar la recopilación de publicaciones después de un fallo.
- Espere que algunas publicaciones públicas omitan comentarios, medios, detalles de reacciones o marcas de tiempo, según la disponibilidad en la fuente.
- Use Facebook Comments API cuando necesite hilos de comentarios públicos más completos que los campos de vista previa básicos.
- Mantenga los datos privados, restringidos, que requieren iniciar sesión o que pertenecen a una cuenta fuera de los supuestos de su integración, salvo que la documentación publicada los admita de forma expresa.
APIs relacionadas
Además de la Facebook Posts API, use estas APIs cuando necesite otro tipo de datos públicos de Facebook.
- Facebook Pages API — Obtiene perfiles públicos de páginas de Facebook, datos de contacto, imágenes y calificaciones visibles de la audiencia.
- 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.