Facebook Event Details
Facebook Event Details es un endpoint de consulta directa para URL de eventos que ya conoce. Envíe una o más URL públicas de Facebook que contengan /events/ para recopilar el ID del evento, la URL canónica, el nombre, la descripción, las horas de inicio y fin, la ubicación, los medios públicos, las métricas visibles y el contexto de recopilación, cuando esos campos estén disponibles.
Funcionalidades de la Facebook Event Details API
- Consulta directa por URL de eventoResuelve URL conocidas de eventos públicos de Facebook sin ejecutar una búsqueda por palabra clave, categoría, ciudad o fecha.
- Metadatos de evento normalizadosDevuelve una estructura de evento estable con campos de identidad, URL canónica, nombre, descripción y marca de tiempo de recopilación.
- Contexto de horario y ubicaciónCaptura las horas de inicio y fin normalizadas y el valor público de la ubicación cuando la fuente los expone.
- Medios y métricas visiblesIncluye los medios públicos normalizados y las métricas habituales de interacción o respuesta cuando están disponibles para el evento.
Parámetros de la Facebook Event Details API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL de eventos públicos de Facebook. Los hosts aceptados son facebook.com, www.facebook.com y m.facebook.com, y la ruta de cada una debe contener /events/. |
Cómo usar la Facebook Event Details API
Envíe URL de eventos como una tarea asíncrona, consulte su ID de tarea y lea los registros de eventos normalizados.
- Prepare una o más URL públicas de facebook.com, www.facebook.com o m.facebook.com cuya ruta contenga /events/.
- Envíe urls por POST a /v1/facebook/event-details.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
- Lea data.results.items desde /v1/tasks/{task_id}?limit=50 y siga results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/facebook/event-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/events/123456789012345/"]}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.Casos de uso de la Facebook Event Details API
- Enriquecimiento de metadatos de eventos: Enriquezca la URL de un evento almacenada con identidad, nombre, descripción, ubicación, horario, medios y métricas visibles, todo normalizado.
- Ingesta de calendarios: Asigne los nombres de eventos, las horas de inicio y fin, las descripciones, las ubicaciones y las URL de origen disponibles a un pipeline de calendario.
- Investigación de organizadores y sedes: Revise la descripción pública, la ubicación, el horario, los medios y las señales de respuesta de una lista existente de URL de eventos.
- Actualización de eventos conocidos: Vuelva a ejecutar URL de eventos guardadas para actualizar los campos públicos que la fuente ofrece en ese momento.
Consejos de expertos para la Facebook Event Details API
- Use la URL canónica de detalle del evento y no la lista de eventos de una página ni otra URL de Facebook que solo incluya un segmento events.
- Trate name, description, location, el horario, los medios y las métricas como opcionales, porque la visibilidad en la fuente varía según el evento.
- Conserve extra.input_url al conciliar resultados de una solicitud con varias URL; una URL enviada puede producir como máximo un registro de evento.
- Los eventos privados, eliminados, restringidos o que requieren iniciar sesión pueden completarse sin devolver ningún registro de evento.
APIs relacionadas
Además de la Facebook Event Details 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 Events Search API — Busca eventos públicos por palabra clave con campos de horario, lugar, asistencia, imagen de portada y estado del evento.
- 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.