facebook/
events-search

Recherchez des événements Facebook publics par mot-clé et obtenez, sous forme d’enregistrements normalisés, l’identité de l’événement, le programme, le lieu, la fréquentation, l’image de couverture et les champs d’état.

Facebook Events Search API

Recherche d’événements
Requête par mot-clé
Événements publics
0,6 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Facebook Events Search

Les événements Facebook sont des fiches publiques avec nom, texte du programme, heure de début, lieu, signaux de fréquentation, image de couverture et statut en ligne ou passé. Ces enregistrements servent à découvrir des événements, à suivre les calendriers, à étudier les lieux et à comparer la fréquentation.

Fonctionnalités de la Facebook Events Search API

  • Découverte d’événements par mot-cléUne requête textuelle permet de trouver les événements Facebook publics liés à un sujet, une activité, une organisation ou un lieu.
  • Identité et programme de l’événementRenvoie, pour chaque événement correspondant, l’ID, le nom, l’URL publique, le texte du programme et l’heure de début normalisée.
  • Contexte du lieu et de l’état de l’événementConserve les ID et noms de lieux ainsi que les statuts en ligne et passé, pour distinguer le contexte du lieu et celui de la date.
  • Fréquentation et image de couvertureInclut les nombres visibles de personnes intéressées, participantes et ayant participé, avec une référence à l’image de couverture publique si elle existe.

Paramètres de la Facebook Events Search API

ParamètresObligatoireDescription
queryObligatoireRequête par mot-clé non vide, utilisée pour rechercher des événements Facebook publics.
results_limitFacultatifNombre maximal d’enregistrements d’événements à collecter, de 7 à 2 000 ; vaut 100 par défaut.

Comment utiliser la Facebook Events Search API

Envoyez un mot-clé sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les événements normalisés grâce à la pagination par curseur.

  1. Préparez une requête par mot-clé non vide et choisissez, si vous le souhaitez, un results_limit de 7 à 2 000.
  2. Envoyez query et results_limit en POST à /v1/facebook/events-search.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  4. Lisez /v1/tasks/{task_id}?limit=50 et poursuivez avec results.next_cursor tant que results.has_more vaut 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.

Cas d’usage de la Facebook Events Search API

  • Découverte d’événements par thème : Avec une requête ciblée, les noms d’événements, les URL publiques et le texte du programme permettent de dresser une liste d’événements publics pertinents.
  • Suivi des calendriers : Comparez d’une collecte à l’autre les heures de début normalisées, le texte du programme, les ID d’événements et le statut d’événement passé.
  • Étude des lieux et des formats : Classez les événements correspondants par ID de lieu, nom de lieu et statut en ligne pour étudier où et sous quelle forme ils sont publiés.
  • Comparaison de la fréquentation visible : Confrontez les nombres de personnes intéressées, participantes et ayant participé d’un enregistrement à l’autre, à côté des noms et des heures de début.

Conseils d’expert pour la Facebook Events Search API

  • Précisez le sujet, l’activité, l’organisation ou le lieu lorsqu’une requête trop large renvoie des événements sans rapport.
  • Réglez results_limit entre 7 et 2 000 selon la couverture voulue ; si vous l’omettez, la requête porte sur les 100 enregistrements par défaut.
  • Servez-vous de l’ID ou de l’URL publique de chaque événement pour fusionner des recherches répétées, afin de ne pas compter deux fois le même événement.
  • Considérez le lieu, l’image de couverture, les nombres de fréquentation et les champs d’état comme facultatifs lorsque vous intégrez les enregistrements à votre application.

En complément de la Facebook Events Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook.

  • Facebook Pages API — Récupérez les profils de Pages publiques, leurs coordonnées, leurs images et les notes d’audience visibles.
  • Facebook Posts API — Collectez les publications publiques, médias, réactions, commentaires et partages à partir d’URL Facebook prises en charge.
  • Facebook Comments API — Collectez les commentaires publics, leurs auteurs, l’engagement, les médias et les liens sources à partir d’URL de publications.
  • Facebook Video Transcript API — Extrayez le texte et le format des transcriptions disponibles à partir d’URL connues de publications vidéo ou de Reels publics.
  • Facebook Event Details API — Collectez les métadonnées normalisées, programmes, lieux, médias et engagement visible à partir d’URL connues d’événements publics.
  • Facebook Profile Events API — Collectez les événements publics associés à des URL de profils ou de Pages, avec noms, programmes, lieux, médias, indicateurs visibles et contexte source.

Explorer d’autres plateformes

Combinez les données Facebook avec les données publiques d’autres plateformes sociales prises en charge.

Facebook Events Search API — FAQ

Facebook Events Search API est une interface programmatique qui recherche des événements Facebook publics à partir d’une requête par mot-clé obligatoire. Elle renvoie l’identité de l’événement, le programme, le lieu, les signaux visibles de fréquentation, l’image de couverture et les champs d’état.

Fournissez une chaîne query non vide. results_limit est facultatif, vaut 100 par défaut et accepte un entier de 7 à 2 000.

Un enregistrement peut comprendre l’ID de l’événement, son titre, son URL publique, le texte du programme, l’heure de début, l’ID et le nom du lieu, les nombres de personnes intéressées, participantes et ayant participé, une image de couverture et le statut en ligne ou passé.

La recherche porte sur les événements publics qui correspondent au mot-clé envoyé. Si aucun résultat public pris en charge ne correspond, la tâche terminée renvoie une liste items vide.

L’utilisation coûte 0,6 crédit pour chaque enregistrement d’événement renvoyé, sans frais de base par tâche.