Facebook Profile Events
Los eventos de perfiles de Facebook son listados públicos de eventos asociados con un perfil o una página, con nombres, descripciones, ubicaciones, horas de inicio y fin, medios y métricas visibles. Su horario y su contexto de origen sirven para enriquecer calendarios de organizadores, investigar inventarios de eventos y comparar páginas.
Funcionalidades de la Facebook Profile Events API
- Feeds de eventos de perfiles y páginasRecopile los listados de eventos públicos asociados con una o más URL de perfiles o páginas de Facebook enviadas.
- Identidad y horario del eventoDevuelve los ID de evento, las URL públicas, los nombres, las descripciones, las ubicaciones y las horas de inicio y fin normalizadas.
- Medios y métricas visiblesConserva las referencias normalizadas a imágenes o videos públicos y las métricas visibles habituales que acompañan a cada evento.
- Contexto de origen normalizadoAdjunta la URL de origen enviada a cada registro normalizado y elimina los eventos duplicados por ID o URL dentro del feed de ese origen.
Parámetros de la Facebook Profile Events API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Una o más URL de perfiles o páginas de Facebook en facebook.com, www.facebook.com o m.facebook.com. |
results_limit | Opcional | Número máximo de registros de eventos por recopilar para cada URL de entrada, de 20 a 2,000; el valor predeterminado es 100. |
Cómo usar la Facebook Profile Events API
Envíe URL de perfiles o páginas como una tarea asíncrona, consulte su ID de tarea y lea los registros de eventos normalizados con paginación por cursor.
- Prepare una o más URL de perfiles o páginas de Facebook y, si lo desea, elija un results_limit de 20 a 2,000 para cada URL.
- Envíe urls y, de forma opcional, results_limit por POST a /v1/facebook/profile-events.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
- Lea /v1/tasks/{task_id}?limit=50 y continúe con results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/facebook/profile-events" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Casos de uso de la Facebook Profile Events API
- Enriquecimiento de calendarios de organizadores: Use los nombres, las descripciones, las ubicaciones y las horas de inicio y fin de los eventos para enriquecer calendarios creados a partir de páginas públicas de organizadores conocidos.
- Inventario de eventos entre páginas: Agrupe los ID y las URL de eventos normalizados por input_url para comparar los listados de eventos públicos entre perfiles o páginas seleccionados.
- Colas de recopilación de detalles de eventos: Use las URL de eventos devueltas para armar una cola deduplicada que permita obtener detalles más completos de cada evento.
- Informes de horarios públicos: Combine los campos de horario, las referencias a medios y las métricas visibles en informes sobre los eventos asociados con fuentes públicas monitoreadas.
Consejos de expertos para la Facebook Profile Events API
- Envíe perfiles o páginas que expongan un feed de eventos; la validación del host por sí sola no confirma que una URL de Facebook sea una fuente adecuada.
- Elija results_limit teniendo en cuenta el número de URL de entrada, porque el límite y el costo estimado según los resultados se aplican por separado a cada URL.
- Cuando un mismo evento pueda estar asociado con varios orígenes enviados, deduplique los resultados combinados por ID de evento o URL pública.
- Trate el texto de la descripción, la ubicación, la hora de fin, los medios y cada valor de métrica como opcionales al asignar los registros a su aplicación.
APIs relacionadas
Además de la Facebook Profile Events 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 Event Details API — Recolecta metadatos normalizados, horarios, ubicaciones, contenido multimedia e interacción visible desde URLs conocidas de eventos públicos.
- 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.