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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Requête par mot-clé non vide, utilisée pour rechercher des événements Facebook publics. |
results_limit | Facultatif | Nombre 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.
- Préparez une requête par mot-clé non vide et choisissez, si vous le souhaitez, un results_limit de 7 à 2 000.
- Envoyez query et results_limit en POST à /v1/facebook/events-search.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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.
API associées
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.