facebook/
posts

Recopile las publicaciones públicas de Facebook a partir de URL de páginas, perfiles, grupos o publicaciones, con texto, contexto del autor, medios, reacciones, conteos de comentarios y veces compartido normalizados.

Facebook Posts API

Publicaciones
Reacciones
Datos públicos
1 crédito 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 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ámetrosObligatorioDescripción
urlsObligatorioURL públicas de páginas, perfiles, grupos o publicaciones de Facebook, separadas por comas o saltos de línea.
results_limitOpcionalNú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.

  1. Prepare una o más URL públicas de páginas, perfiles, grupos o publicaciones de Facebook.
  2. Envíe urls y, de forma opcional, results_limit por POST a /v1/facebook/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 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.

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.

Explorar otras plataformas

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

Facebook Posts API — FAQ

Facebook Posts API recopila publicaciones de acceso público a partir de URL de páginas, perfiles, grupos o publicaciones de Facebook. Devuelve texto, contexto del autor, referencias a medios, marcas de tiempo, reacciones, conteos de comentarios y veces compartido, todo normalizado.

Envíe URL públicas de páginas, perfiles, grupos abiertos o publicaciones de Facebook. Los grupos privados, los perfiles restringidos, las publicaciones eliminadas y las superficies que requieren iniciar sesión pueden devolver datos limitados o ningún registro.

Los campos habituales del resultado incluyen id, url, message, author, metrics, reactions, media, created_at, collected_at y extra. Los metadatos de tareas y de paginación de resultados se devuelven en las respuestas de la API que los rodean.

La recopilación de publicaciones públicas no requiere cookies de Facebook proporcionadas por el cliente. El contenido que solo aparece tras iniciar sesión queda fuera del límite de datos públicos.

Se devuelven imágenes, videos, detalles de reacciones y conteos visibles de comentarios cuando la publicación pública los expone. Use Facebook Comments API cuando necesite registros de comentarios individuales y trate los campos opcionales de medios o reacciones como valores que pueden ser nulos.

Use tamaños de página conservadores, retroceso exponencial tras respuestas 429 o de presión similar y evite los bucles de reintento muy seguidos. En las tareas grandes, recopile en lotes más pequeños y retome desde los cursores guardados.

Revise que el destino sea accesible públicamente, que la publicación no se haya eliminado ni restringido y que los campos opcionales solicitados estén expuestos públicamente. Facebook cambia con frecuencia la estructura de las páginas públicas, por lo que los clientes deben tratar los campos ausentes como un caso normal de disponibilidad.