facebook/
profile-events

Recopile los eventos públicos asociados con URL de perfiles o páginas de Facebook, con nombres, descripciones, horarios, ubicaciones, medios, métricas visibles y contexto de origen en registros normalizados.

Facebook Profile Events API

Eventos de perfiles
URL por lotes
Datos 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 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ámetrosObligatorioDescripción
urlsObligatorioUna o más URL de perfiles o páginas de Facebook en facebook.com, www.facebook.com o m.facebook.com.
results_limitOpcionalNú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.

  1. 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.
  2. Envíe urls y, de forma opcional, results_limit por POST a /v1/facebook/profile-events.
  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/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.

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.

Explorar otras plataformas

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

Facebook Profile Events API — FAQ

Facebook Profile Events API es una interfaz programática que reúne los eventos públicos asociados con un perfil o una página de Facebook específicos, sin necesidad de localizar cada evento por separado. Sirve para calendarios de organizadores, inventarios de eventos y comparaciones entre páginas; su destino es una fuente pública de eventos y no la URL de un evento individual.

Envíe una o más URL alojadas en facebook.com, www.facebook.com o m.facebook.com. La validación comprueba el host, así que use perfiles o páginas adecuados para un feed de eventos públicos.

results_limit tiene un valor predeterminado de 100 y acepta enteros de 20 a 2,000. El límite se aplica por separado a cada URL enviada, y la recopilación de un origen puede terminar antes si ya no hay más eventos públicos disponibles.

Que el host de Facebook sea válido no garantiza que el destino exponga un feed de eventos públicos compatible. También pueden faltar los eventos no disponibles, eliminados, antiguos, privados o con acceso restringido por inicio de sesión.

Consulte el ID de tarea devuelto hasta que su estado sea succeeded y luego lea los registros de eventos guardados desde el endpoint de resultados de la tarea.

El uso cuesta 0.6 créditos por cada registro de evento guardado, sin cargo base por tarea. Por lo tanto, un resultado completado y vacío no genera cargo por resultado.