facebook/
pages

Recopile los perfiles públicos de páginas de Facebook a partir de una o más URL de páginas, con identidad, datos de contacto, imágenes, conteos de seguidores y Me gusta, reseñas y calificaciones normalizados.

Facebook Pages API

Páginas
Perfiles
Datos públicos
2.4 créditos 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 Pages

Las páginas de Facebook son perfiles públicos de negocios, organizaciones, creadores de contenido y figuras públicas, con identidad, categorías, descripciones, imágenes, datos de contacto y señales de audiencia. Estos campos de perfil y de audiencia sirven para descubrir marcas, enriquecer directorios, hacer estudios de mercado y comparar cuentas.

Funcionalidades de la Facebook Pages API

  • Recopilación de páginas por lotesRecopile una o más páginas públicas de Facebook a partir de sus URL.
  • Identidad e imágenes de la páginaDevuelve el nombre de la página, la categoría, el texto de información, la URL canónica, el avatar y la imagen de portada como campos de perfil normalizados.
  • Métricas de audiencia visiblesIncluye las métricas visibles de seguidores, Me gusta de la página, reseñas y calificaciones en un objeto metrics uniforme.
  • Datos de contacto públicosDevuelve los campos públicos de sitio web, correo electrónico, teléfono y dirección para enriquecer contactos y directorios.
  • Límite de datos públicosLimita los resultados a los datos de páginas de acceso público; el contenido privado, restringido o que requiere iniciar sesión queda fuera de la respuesta.

Parámetros de la Facebook Pages API

ParámetrosObligatorioDescripción
urlsObligatorioURL de páginas públicas 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 Pages API

Envíe una tarea de recopilación, consulte su ID de tarea hasta que termine el procesamiento y lea los registros de páginas normalizados con paginación por cursor.

  1. Prepare una o más URL de páginas públicas de Facebook.
  2. Envíe urls y, de forma opcional, results_limit por POST a /v1/facebook/pages.
  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.
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}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Casos de uso de la Facebook Pages API

  • Monitoreo de páginas de marca: Recopile la identidad pública, la categoría, el contacto y las métricas de audiencia de una página para dar seguimiento a páginas propias o de la competencia.
  • Conjuntos de datos de referencia de páginas: Compare las categorías, las descripciones, la cobertura de contacto, los conteos de seguidores, las calificaciones y otras señales visibles de audiencia entre páginas seleccionadas.
  • Informes y pipelines de BI: Envíe registros públicos de páginas normalizados a paneles, hojas de cálculo, almacenes de datos o herramientas internas de revisión.
  • Flujos de archivo de medios: Almacene las URL de las páginas, las imágenes, las descripciones, los campos de contacto y las métricas visibles para revisarlos o reportarlos más adelante.
  • Escucha social pública: Use la identidad pública de las páginas y las señales de audiencia para enriquecer catálogos de cuentas sociales y conjuntos de datos de marcas.

Consejos de expertos para la Facebook Pages API

  • Valide que cada URL enviada corresponda a una página pública de Facebook antes de iniciar un lote grande.
  • Espere que algunas páginas públicas omitan campos de contacto, imágenes, calificaciones o contadores de audiencia, según la disponibilidad de los resultados.
  • Conserve los ID estables de las páginas y las URL canónicas para poder reintentar, auditar y deduplicar las tareas.
  • Use Facebook Posts API cuando su flujo de trabajo necesite registros de publicaciones públicas de una página o de otra URL compatible.
  • Evite diseñar flujos que dependan de páginas privadas, publicaciones restringidas, superficies con sesión iniciada o datos propiedad de una cuenta, salvo que la documentación publicada los admita de forma expresa.

Además de la Facebook Pages 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 Profile Events API — Recolecta eventos públicos asociados a URLs de perfiles o páginas, con nombres, horarios, ubicaciones, contenido multimedia, métricas visibles y contexto de origen.
  • Facebook Profile Photos API — Recolecta fotos públicas desde URLs de perfiles o páginas con descripciones, contexto del autor, interacción, metadatos de imagen y referencias de origen.
  • 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.
  • Facebook Reels API — Recolecta Reels públicos desde URLs de perfiles o páginas con descripciones, contexto del autor, metadatos de video, interacción visible y referencias de origen.

Explorar otras plataformas

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

Facebook Pages API — FAQ

Facebook Pages API recupera perfiles de páginas de acceso público a partir de una o más URL de páginas de Facebook. Devuelve identidad, categorías, descripciones, imágenes, datos de contacto, conteos de seguidores y Me gusta, reseñas y calificaciones, todo normalizado.

La recopilación básica de páginas públicas no requiere credenciales de aplicación de Facebook ni iniciar sesión en Facebook. No debe usarse para suponer acceso a contenido privado, restringido o que requiere iniciar sesión.

Los campos habituales incluyen el ID de la página, el nombre, la URL canónica, la categoría, el texto de información, el avatar, la imagen de portada, los conteos de seguidores y Me gusta, las reseñas, la calificación, el sitio web, el correo electrónico, el teléfono y la dirección.

Sí, cuando los resultados públicos de la página exponen las URL de la imagen de perfil y de portada. Los clientes deben contemplar las páginas que omiten una de las imágenes o ambas.

El objeto metrics normalizado puede incluir el conteo visible de seguidores, el conteo de Me gusta de la página, el conteo de reseñas y la calificación, cuando el resultado público los expone.

El contenido de Facebook es dinámico y las estructuras de los resultados públicos pueden cambiar. Los campos vacíos, los tiempos de espera agotados, la falta de datos de contacto o las solicitudes bloqueadas deben tratarse como casos normales de disponibilidad y de presión sobre el límite de solicitudes.

Use límites más pequeños, frecuencias de solicitud conservadoras, retroceso exponencial tras los fallos y tiempos de espera de procesamiento más largos para páginas grandes. Evite la recopilación repetida de alto volumen desde la misma página.