facebook/
events-search

Busque eventos públicos de Facebook por palabra clave, con identidad del evento, horario, lugar, asistencia, imagen de portada y campos de estado en registros normalizados.

Facebook Events Search API

Búsqueda de eventos
Consulta por palabra clave
Eventos públicos
0.6 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 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ámetrosObligatorioDescripción
queryObligatorioConsulta por palabra clave, no vacía, que se usa para buscar eventos públicos de Facebook.
results_limitOpcionalNú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.

  1. Prepare una consulta por palabra clave que no esté vacía y, si lo desea, elija un results_limit de 7 a 2,000.
  2. Envíe query y results_limit por POST a /v1/facebook/events-search.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
  4. 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.

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.

Explorar otras plataformas

Combine los datos de Facebook con datos públicos de otras plataformas sociales compatibles.

Facebook Events Search API — FAQ

Facebook Events Search API es una interfaz programática para buscar eventos públicos de Facebook mediante una consulta por palabra clave obligatoria. Devuelve la identidad del evento, el horario, el lugar, las señales visibles de asistencia, la imagen de portada y los campos de estado del evento.

Indique una cadena query que no esté vacía. results_limit es opcional, tiene un valor predeterminado de 100 y acepta un entero de 7 a 2,000.

Un registro puede incluir el ID del evento, el título, la URL pública, el texto del horario, la hora de inicio, el ID y nombre del lugar, los conteos de interesados, confirmados y asistentes, una imagen de portada y el estado de evento en línea o ya pasado.

La búsqueda abarca eventos públicos que coinciden con la palabra clave enviada. Si no hay resultados públicos compatibles, la tarea completada devuelve una lista items vacía.

El uso cuesta 0.6 créditos por cada registro de evento devuelto, sin cargo base por tarea.