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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL 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_limit | Opcional | Nú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.
- Prepare una o más URL de páginas públicas de Facebook cuya ruta contenga /reviews.
- Envíe urls y, de forma opcional, results_limit por POST a /v1/facebook/company-reviews.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
- 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.
APIs relacionadas
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.