Facebook Profile Events
Les événements de profils Facebook sont des fiches publiques d’événements rattachées à un profil ou à une Page, avec noms, descriptions, lieux, dates de début et de fin, médias et indicateurs visibles. Leur programme et leur contexte de source servent à enrichir le calendrier d’un organisateur, à étudier l’offre d’événements et à comparer plusieurs Pages.
Fonctionnalités de la Facebook Profile Events API
- Flux d’événements de profils et de PagesCollecte les événements publics associés à une ou plusieurs URL de profils ou de Pages Facebook envoyées.
- Identité et programme de l’événementRenvoie les ID d’événements, les URL publiques, les noms, les descriptions, les lieux et les heures de début et de fin normalisées.
- Médias et indicateurs visiblesConserve les références normalisées d’images ou de vidéos publiques ainsi que les indicateurs visibles courants fournis avec chaque événement.
- Contexte de source normaliséRattache l’URL source envoyée à chaque enregistrement normalisé, tout en supprimant les événements en double par ID ou par URL au sein du flux de cette source.
Paramètres de la Facebook Profile Events API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Une ou plusieurs URL de profils ou de Pages Facebook sur facebook.com, www.facebook.com ou m.facebook.com. |
results_limit | Facultatif | Nombre maximal d’enregistrements d’événements à collecter par URL d’entrée, de 20 à 2 000 ; vaut 100 par défaut. |
Comment utiliser la Facebook Profile Events API
Envoyez des URL de profils ou de Pages 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 ou plusieurs URL de profils ou de Pages Facebook et choisissez, si vous le souhaitez, un results_limit de 20 à 2 000 pour chaque URL.
- Envoyez urls, avec results_limit en option, en POST à /v1/facebook/profile-events.
- 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/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.Cas d’usage de la Facebook Profile Events API
- Enrichissement du calendrier d’un organisateur : Servez-vous des noms, descriptions, lieux et heures de début et de fin d’événements pour enrichir des calendriers bâtis à partir de Pages d’organisateurs publiques connues.
- Panorama d’événements sur plusieurs Pages : Regroupez les ID et URL d’événements normalisés par input_url pour comparer les événements publics de profils ou de Pages sélectionnés.
- Files de collecte des détails d’événements : Utilisez les URL d’événements renvoyées pour constituer une file dédoublonnée destinée à récupérer des détails plus complets.
- Rapports sur les programmes publics : Combinez champs de programme, références de médias et indicateurs visibles dans des rapports sur les événements liés à des sources publiques suivies.
Conseils d’expert pour la Facebook Profile Events API
- Envoyez des profils ou des Pages qui exposent un flux d’événements : la validation de l’hôte seule ne confirme pas qu’une URL Facebook constitue une source adaptée.
- Choisissez results_limit en tenant compte du nombre d’URL d’entrée, car la limite et le coût estimé selon les résultats s’appliquent séparément à chaque URL.
- Lorsqu’un même événement peut se rattacher à plusieurs sources envoyées, dédoublonnez les résultats fusionnés par ID d’événement ou par URL publique.
- Considérez le texte de description, le lieu, l’heure de fin, les médias et chaque valeur d’indicateur comme facultatifs lorsque vous intégrez les enregistrements à votre application.
API associées
En complément de la Facebook Profile Events 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 Profiles API — Consultez des profils ou Pages publics à partir d’URL Facebook connues avec identité, bio, avatar, compteurs visibles et contexte de la saisie.