facebook/
company-reviews

Recopile las reseñas públicas de páginas de Facebook a partir de URL /reviews, con texto de la reseña, enlaces de los autores, calificaciones, Me gusta, marcas de tiempo y contexto de la empresa en registros normalizados.

Facebook Company Reviews API

Reseñas de páginas
Contexto del autor de la reseña
Calificaciones de empresas
0.5 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 Company Reviews

Las reseñas de empresas en Facebook son recomendaciones o calificaciones públicas de una página, con comentarios escritos, identidad de quien reseña, hora de publicación, Me gusta visibles y señales de reseñas a nivel de la empresa. Estos registros sirven para investigar opiniones, tomar instantáneas de reputación, analizar el contexto de los autores y comparar páginas conocidas.

Funcionalidades de la Facebook Company Reviews API

  • Recopilación por URL de reseñas de páginasAcepta una o más URL /reviews compatibles de páginas de Facebook y recopila las filas de reseñas públicas disponibles para cada entrada.
  • Registros de reseñas y de quienes reseñanDevuelve los ID de reseña, las URL de origen, el texto, los nombres y enlaces de perfil de los autores, los Me gusta visibles, las calificaciones y las horas de publicación en una estructura normalizada.
  • Contexto a nivel de empresaMantiene los nombres de las empresas, las URL de las páginas, las calificaciones agregadas y el total de reseñas junto a cada reseña, para comparar por fuente.

Parámetros de la Facebook Company Reviews API

ParámetrosObligatorioDescripción
urlsObligatorioURL de reseñas de páginas de Facebook en facebook.com, www.facebook.com o m.facebook.com cuya ruta contenga /reviews, separadas por comas o saltos de línea.
results_limitOpcionalNúmero máximo de reseñas solicitadas por cada URL de entrada, de 20 a 2,000; el valor predeterminado es 100 y los resultados públicos disponibles pueden ser menos.

Cómo usar la Facebook Company Reviews API

Envíe URL /reviews de páginas de Facebook como una tarea asíncrona, consulte su ID de tarea y lea los registros de reseñas normalizados con paginación por cursor.

  1. Prepare una o más URL de páginas públicas de Facebook cuya ruta contenga /reviews.
  2. Envíe urls y, de forma opcional, results_limit por POST a /v1/facebook/company-reviews.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
  4. Lea /v1/tasks/{task_id}?limit=50 y pase results.next_cursor como cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/facebook/company-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/PepsiCo/reviews/"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Casos de uso de la Facebook Company Reviews API

  • Preparación de conjuntos de datos de opiniones: Use el texto de las reseñas, las calificaciones, las horas de publicación y las URL de origen para preparar conjuntos de datos de opiniones públicas destinados a análisis posteriores de temas o sentimiento.
  • Informes de instantáneas de reputación: Combine las calificaciones de cada reseña con las calificaciones de la empresa y el total de reseñas para documentar el estado visible de páginas seleccionadas.
  • Investigación de la interacción de quienes reseñan: Use los nombres, los enlaces de perfil y la cantidad de Me gusta visibles para examinar quiénes dejaron opiniones públicas y qué reseñas generaron interacción.

Consejos de expertos para la Facebook Company Reviews API

  • Use una URL /reviews de página de Facebook que se pueda resolver, y no el nombre de una empresa ni la URL general de una página.
  • Defina results_limit para cada URL de entrada según la profundidad que necesite, y espere menos filas cuando Facebook exponga menos historial público de reseñas.
  • Envíe cada URL de página una sola vez, porque las URL de entrada duplicadas se eliminan antes de la recopilación.
  • Trate los enlaces de los autores, las calificaciones, los Me gusta, las marcas de tiempo y los agregados de la empresa como valores que pueden ser nulos cuando Facebook no expone alguno.
  • Siga results.next_cursor hasta que results.has_more sea false para leer las tareas grandes ya completadas sin omitir registros almacenados.

Además de la Facebook Company Reviews 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 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 Video Transcript API — Extrae el texto de transcripción disponible y su formato desde URLs conocidas de videos o Reels públicos.
  • Facebook Comment Replies API — Obtiene las respuestas públicas a un comentario conocido a partir de su ID de feedback y su token de expansión, con texto, identidad del autor, interacción y contexto del comentario principal.
  • 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 Company Reviews API — FAQ

Facebook Company Reviews API es una interfaz programática que reúne las reseñas y recomendaciones de la URL /reviews de una página pública de Facebook en un conjunto de opiniones uniforme. Ofrece a los equipos de reputación una base para instantáneas, análisis de temas y comparaciones entre páginas conocidas, siempre limitada al contenido visible en las páginas de reseñas públicas.

Envíe una o más URL de páginas de Facebook en facebook.com, www.facebook.com o m.facebook.com con /reviews en la ruta. El nombre de una empresa o la URL de una página no relacionada no son sustitutos válidos.

Un registro puede contener el ID y la URL de la reseña, el texto, el nombre y la URL de perfil de quien reseña, los Me gusta visibles, el valor de la calificación, created_at, collected_at, el nombre y la URL de la empresa, la calificación de la empresa y el total de reseñas.

results_limit tiene un valor predeterminado de 100 y acepta enteros de 20 a 2,000 para cada URL de entrada. Es un tope, por lo que la visibilidad pública y la disponibilidad de la fuente pueden producir menos reseñas.

Consulte el ID de tarea devuelto hasta que su estado sea succeeded y luego lea los registros de reseñas guardados desde el endpoint de resultados de la tarea.

Cada registro de reseña que se guarda cuesta 0.5 créditos, sin cargo base por tarea. Por lo tanto, un resultado vacío no genera cargo por resultado.