Facebook Events Search
Los eventos de Facebook son listados públicos con nombres, texto del horario, horas de inicio, lugares, señales de asistencia, imágenes de portada y el estado de evento en línea o ya pasado. Estos registros sirven para descubrir eventos, monitorear horarios, investigar sedes y comparar la asistencia.
Funcionalidades de la Facebook Events Search API
- Descubrimiento de eventos por palabra claveUse una consulta de texto para encontrar registros de eventos públicos de Facebook asociados con un tema, una actividad, una organización o un lugar.
- Identidad y horario del eventoDevuelve los ID de evento, los nombres, las URL públicas, el texto del horario y las horas de inicio normalizadas de los registros coincidentes.
- Contexto del lugar y del estado del eventoConserva los ID y nombres de lugar, el estado en línea y el estado de evento ya pasado para distinguir el contexto de la sede y del momento.
- Campos de asistencia y portadaIncluye los conteos visibles de interesados, confirmados y asistentes, junto con una referencia a la imagen de portada pública cuando existe.
Parámetros de la Facebook Events Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Consulta por palabra clave, no vacía, que se usa para buscar eventos públicos de Facebook. |
results_limit | Opcional | Número máximo de registros de eventos por recopilar, de 7 a 2,000; el valor predeterminado es 100. |
Cómo usar la Facebook Events Search API
Envíe una palabra clave como una tarea asíncrona, consulte su ID de tarea y lea los registros de eventos normalizados con paginación por cursor.
- Prepare una consulta por palabra clave que no esté vacía y, si lo desea, elija un results_limit de 7 a 2,000.
- Envíe query y results_limit por POST a /v1/facebook/events-search.
- 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/events-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"technology conference","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 Events Search API
- Descubrimiento de eventos por tema: Use una consulta específica, junto con los nombres de eventos, las URL públicas y el texto del horario, para armar una lista de eventos públicos relevantes.
- Monitoreo de horarios: Compare entre recopilaciones las horas de inicio normalizadas, el texto del horario, los ID de evento y el estado de evento ya pasado.
- Investigación de sedes y formatos: Organice los eventos coincidentes por ID de lugar, nombre de lugar y estado en línea para estudiar dónde y cómo se publican los eventos.
- Comparación de la asistencia visible: Compare los conteos de interesados, confirmados y asistentes entre registros de eventos, junto con sus nombres y horas de inicio.
Consejos de expertos para la Facebook Events Search API
- Use una frase específica de tema, actividad, organización o lugar cuando una consulta amplia devuelva registros de eventos no relacionados.
- Defina results_limit entre 7 y 2,000 según la cobertura que necesite; si lo omite, se solicitan los 100 registros predeterminados.
- Use el ID de evento o la URL pública de cada evento al combinar búsquedas repetidas, para no contar dos veces el mismo evento.
- Trate los campos de lugar, portada, conteos de asistencia y estado del evento como opcionales al asignar los registros a su aplicación.
APIs relacionadas
Además de la Facebook Events Search 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 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.