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.

facebook/pages
Perfiles2.4 créditos por resultado

facebook/posts
Publicaciones1 crédito por resultado

facebook/group-posts
Publicaciones1.2 créditos por resultado

facebook/reels
Publicaciones0.7 créditos por resultado

facebook/comments
Comentarios0.3 créditos por resultado

facebook/comment-replies
Comentarios0.3 créditos por resultado

facebook/company-reviews
Comentarios0.5 créditos por resultado

facebook/video-transcript
Publicaciones0.7 créditos por resultado

facebook/ad-transcript
Publicaciones0.5 créditos por resultado

facebook/events-search
Búsqueda0.6 créditos por resultado

facebook/event-details
Búsqueda0.5 créditos por resultado

facebook/profile-events
Perfiles0.6 créditos por resultado

facebook/profile-photos
Publicaciones0.5 créditos por resultado

facebook/profiles
Perfiles1.2 créditos por resultado
¿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.
| Funcionalidad | SocQ | Facebook Graph API |
|---|---|---|
| Uso principal | Recolección de datos públicos de páginas, publicaciones, publicaciones de grupos, comentarios, eventos y transcripciones | Administrar páginas, apps y activos autorizados |
| OAuth del cliente | Clave de API de SocQ; sin OAuth de Facebook del cliente | Revisión de la app de Meta, permisos y tokens de acceso |
| Crear o editar publicaciones | No compatible | Compatible con los permisos de página correspondientes |
| Datos privados o restringidos | No compatible | Solo los datos otorgados mediante permisos autorizados |
| Formato de respuesta | Registros normalizados de SocQ | Objetos 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. 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. 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. Leer y paginar
Obtenga los elementos de resultado normalizados y siga next_cursor cuando la tarea contenga más registros.
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=50Casos 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.
Combine datos de varias plataformas para obtener información de negocio más completa
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.
X API
Recopile perfiles públicos, relaciones de seguidores y seguidos, posts, respuestas, citas, quienes hicieron repost, resultados de búsqueda y tendencias actuales. Use resultados consistentes para investigación y monitoreo.
LinkedIn API
Obtenga datos públicos de perfiles, empresas, publicaciones y empleos de LinkedIn a partir de URL conocidas, con campos normalizados de identidad, trayectoria profesional, empresa, contenido, interacción y empleo.
Reddit API
Obtenga publicaciones y comentarios públicos de Reddit a partir de URL conocidas, explore publicaciones nuevas, principales o populares de un subreddit, o busque conversaciones por palabra clave y período de publicación.
Pinterest API
Obtenga datos de perfiles públicos de Pinterest, resuelva Pins conocidos, recopile Pins de perfiles seleccionados o busque por palabra clave para investigar creadores de contenido, contenidos y tendencias visuales.
Threads API
Obtenga perfiles públicos de Threads, resuelva publicaciones conocidas o recopile publicaciones de perfiles seleccionados con campos normalizados de identidad, contenido, multimedia, interacción y marca de tiempo.
Bluesky API
Obtenga perfiles públicos de Bluesky, resuelva URL de publicaciones conocidas o recopile una página de publicaciones de una cuenta con identidad, contenido, contenido multimedia, marcas de tiempo y campos visibles de interacción normalizados.