Volver a las API
Datos públicos de Facebook

Facebook Public Data API

Obtenga perfiles públicos de páginas de Facebook, publicaciones, publicaciones de grupos, comentarios, eventos que coinciden con una palabra clave y transcripciones de video disponibles, con campos normalizados de identidad, contenido, origen, formato, lugar, contenido multimedia, reacciones, asistencia e interacción.

API de Facebook disponibles

Use Pages para los campos del perfil público, Posts para contenido general, Group Posts para registros a partir de la URL de un grupo, Comments para las conversaciones, Events Search para eventos que coinciden con una palabra clave y Video Transcripts para el texto hablado disponible de URL conocidas de publicaciones de video o Reels. Las seis comparten la misma autenticación y el mismo patrón de resultados de tareas.

¿Qué datos de Facebook se pueden obtener?

SocQ convierte los resultados públicos de Facebook compatibles en registros JSON consistentes para flujos de enriquecimiento, monitoreo, investigación y generación de informes.

Perfiles de páginas públicas

Obtenga nombres de páginas, categorías, descripciones, URL canónicas, imágenes de perfil e imágenes de portada cuando son de acceso público.

Campos de contacto y audiencia

Devuelva sitios web, correos electrónicos, números de teléfono, ubicaciones, cantidad de seguidores, Me gusta de la página, calificaciones y conteos de reseñas públicos cuando estén expuestos.

Contenido de publicaciones públicas

Obtenga el texto de las publicaciones, los autores, las marcas de tiempo, los enlaces, las imágenes, las referencias de video y los identificadores de publicación normalizados.

Comentarios públicos e interacción

Obtenga el texto de comentarios públicos, los campos del autor, las marcas de tiempo, los Me gusta, la cantidad de respuestas, las veces compartido y las señales de reacciones cuando estén disponibles.

Descubrimiento de eventos públicos

Busque por palabra clave nombres de eventos, horarios, lugares, señales de asistencia, imágenes de portada y el estado en línea o de evento pasado.

Transcripciones de video disponibles

Extraiga el texto de la transcripción vinculado a su fuente y su formato de texto plano o WebVTT a partir de URL públicas conocidas de publicaciones de video o Reels.

SocQ vs Facebook Graph API

SocQ se centra en la recolección de datos públicos compatibles. La Graph API de Meta es la opción adecuada para administrar los activos que una persona o una empresa ha autorizado de forma explícita.

FuncionalidadSocQFacebook Graph API
Uso principalRecolección de datos públicos de páginas, publicaciones, publicaciones de grupos, comentarios, eventos y transcripcionesAdministrar páginas, apps y activos autorizados
OAuth del clienteClave de API de SocQ; sin OAuth de Facebook del clienteRevisión de la app de Meta, permisos y tokens de acceso
Crear o editar publicacionesNo compatibleCompatible con los permisos de página correspondientes
Datos privados o restringidosNo compatibleSolo los datos otorgados mediante permisos autorizados
Formato de respuestaRegistros normalizados de SocQObjetos nativos de la Graph API

Cómo funciona la API de Facebook

La recolección se ejecuta de forma asíncrona para que su aplicación pueda enviar el trabajo, supervisar su estado y procesar las páginas de resultados de forma independiente.

  1. 1. Enviar una entrada

    Envíe por POST URL públicas compatibles de páginas, publicaciones, grupos, publicaciones de video o Reels, o una consulta por palabra clave para la búsqueda de eventos, con los campos documentados del endpoint elegido.

  2. 2. Consultar la tarea

    Use el ID de tarea devuelto hasta que el procesamiento termine con éxito o con error. Espere más tiempo entre consultas tras recibir respuestas de saturación temporal.

  3. 3. Leer y paginar

    Obtenga los elementos de resultado normalizados y siga next_cursor cuando la tarea contenga más registros.

Comenzar con una sola solicitud a la API

Autentíquese con una clave de API de SocQ. Este ejemplo inicia una tarea de una página pública de Facebook; use /v1/facebook/posts para publicaciones generales, /v1/facebook/group-posts para publicaciones de grupos, /v1/facebook/comments para comentarios, /v1/facebook/events-search para descubrir eventos o /v1/facebook/video-transcript para URL conocidas de publicaciones de video y Reels.

curl -X POST "https://api.socq.ai/v1/facebook/pages" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/Meta"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casos de uso frecuentes de la API de Facebook

Monitoreo de marcas

Dé seguimiento a la identidad pública de la página, el contacto, la audiencia y las señales de las publicaciones de marcas propias o de la competencia.

Investigación de contenido y respuestas

Analice publicaciones públicas, texto de comentarios, autores, marcas de tiempo, contenido multimedia y la interacción visible para informes o investigación editorial.

Enriquecimiento de páginas

Agregue campos públicos de identidad, categoría, contacto y audiencia de Facebook a registros de CRM, directorios o cuentas.

Descubrimiento y monitoreo de eventos

Use los campos de identidad, horario, lugar, asistencia, portada y estado de los eventos que coinciden con una palabra clave para organizar registros de eventos públicos.

Pipelines de informes

Envíe registros normalizados de páginas y publicaciones públicas a paneles, almacenes de datos y herramientas internas de revisión.

Indexación de contenido hablado

Indexe el texto de transcripción disponible junto con su URL de origen y su formato para publicaciones de video públicas y Reels seleccionados.

Límites y política de datos públicos

Los resultados públicos de Facebook son dinámicos. Un campo visible en una página, publicación, comentario, evento o fuente de transcripción puede estar ausente en otro registro o cambiar con el tiempo.

  • No se admiten grupos privados, perfiles restringidos, publicaciones eliminadas ni contenido que requiera iniciar sesión.
  • Los registros públicos pueden omitir campos de contacto, autores de comentarios, contenido multimedia, contadores, marcas de tiempo, respuestas o el desglose de reacciones.
  • Una URL pública de video enviada no genera un registro de transcripción cuando no hay texto de transcripción disponible.
  • Use lotes más pequeños, frecuencias de solicitud conservadoras y espere más tiempo entre intentos tras bloqueos temporales o saturación del límite de solicitudes.
  • Estos endpoints no crean, actualizan, moderan ni eliminan contenido de Facebook.

Preguntas frecuentes sobre la API de Facebook

¿Es esta la Graph API oficial de Facebook?

No. SocQ normaliza los resultados públicos de Facebook compatibles. Para la administración, la publicación y la moderación autorizadas de páginas, use la Graph API de Meta.

¿Es necesario conectar cuentas de Facebook?

No se requiere OAuth de Facebook del cliente para los endpoints de datos públicos compatibles. Las solicitudes se autentican con una clave de API de SocQ.

¿SocQ puede obtener datos de grupos o perfiles privados?

No. El contenido privado, restringido o que requiere iniciar sesión en Facebook queda fuera del alcance compatible.

¿Cómo se factura el uso?

La tarjeta de cada endpoint muestra su precio actual en créditos por resultado. Las tareas se facturan según los registros normalizados que devuelven.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.