facebook/
event-details

Convierta URL conocidas de eventos públicos de Facebook en registros de eventos normalizados, con metadatos, horario, ubicación, medios y métricas de respuesta visibles.

Facebook Event Details API

Detalles de eventos
Búsqueda por URL
Eventos públicos
0.5 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 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ámetrosObligatorioDescripción
urlsObligatorioLista 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.

  1. Prepare una o más URL públicas de facebook.com, www.facebook.com o m.facebook.com cuya ruta contenga /events/.
  2. Envíe urls por POST a /v1/facebook/event-details.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded.
  4. 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.

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.

Explorar otras plataformas

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

Facebook Event Details API — FAQ

Facebook Event Details API es una interfaz programática que convierte la URL de un evento público conocido de Facebook en una vista estructurada de su horario, ubicación y demás detalles. El registro resultante sirve para enriquecer directorios de eventos, sincronizar calendarios y dar seguimiento a eventos individuales, con una cobertura limitada a la información de eventos de acceso público.

Envíe URL de facebook.com, www.facebook.com o m.facebook.com cuya ruta contenga /events/. La URL de una lista de eventos de una página o una ruta de evento mal formada pueden pasar la validación básica de forma y aun así no devolver ningún registro.

No. No descubre eventos por palabra clave, categoría, ciudad o fecha. Úselo cuando ya cuente con las URL de eventos individuales.

El evento puede ser privado, haber sido eliminado, estar restringido, requerir iniciar sesión, estar mal formado o no estar disponible de otro modo para la consulta pública de detalles en la fuente.

El uso cuesta 0.5 créditos por cada registro de evento devuelto, sin cargo base por tarea. Un resultado vacío no genera cargo por resultado.