Facebook Event Details
Facebook Event Details est un endpoint de consultation directe pour les URL d’événements que vous possédez déjà. Envoyez une ou plusieurs URL Facebook publiques contenant /events/ pour récupérer l’ID de l’événement, son URL canonique, son nom, sa description, ses dates de début et de fin, son lieu, ses médias publics, ses indicateurs visibles et le contexte de collecte, dans la mesure où ces champs sont disponibles.
Fonctionnalités de la Facebook Event Details API
- Consultation directe par URL d’événementRésout des URL d’événements Facebook publics connues, sans lancer de recherche par mot-clé, catégorie, ville ou date.
- Métadonnées d’événement normaliséesRenvoie une forme d’événement stable, avec l’identité, l’URL canonique, le nom, la description et l’horodatage de collecte.
- Contexte de programme et de lieuSaisit les dates de début et de fin normalisées ainsi que le lieu public lorsque la source les expose.
- Médias et indicateurs visiblesInclut les médias publics normalisés et les indicateurs courants d’engagement ou de réponse lorsqu’ils sont disponibles pour l’événement.
Paramètres de la Facebook Event Details API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Tableau obligatoire d’URL d’événements Facebook publics. Les hôtes acceptés sont facebook.com, www.facebook.com et m.facebook.com, et chaque chemin doit contenir /events/. |
Comment utiliser la Facebook Event Details API
Envoyez des URL d’événements sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les enregistrements d’événements normalisés.
- Préparez une ou plusieurs URL publiques en facebook.com, www.facebook.com ou m.facebook.com dont le chemin contient /events/.
- Envoyez urls en POST à /v1/facebook/event-details.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez data.results.items depuis /v1/tasks/{task_id}?limit=50 et suivez results.next_cursor tant que results.has_more vaut 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.Cas d’usage de la Facebook Event Details API
- Enrichissement des métadonnées d’événements : Complétez une URL d’événement déjà stockée avec l’identité, le nom, la description, le lieu, les horaires, les médias et les indicateurs visibles, le tout normalisé.
- Alimentation d’un calendrier : Injectez les noms, dates de début et de fin, descriptions, lieux et URL sources disponibles dans un pipeline de calendrier.
- Étude des organisateurs et des lieux : Passez en revue la description publique, le lieu, le programme, les médias et les signaux de réponse d’une liste existante d’URL d’événements.
- Actualisation d’événements connus : Relancez des URL d’événements enregistrées pour rafraîchir les champs publics actuellement disponibles à la source.
Conseils d’expert pour la Facebook Event Details API
- Utilisez l’URL canonique de la page de détail d’un événement plutôt que la liste d’événements d’une Page ou toute autre URL Facebook qui contient simplement un segment events.
- Considérez le nom, la description, le lieu, le programme, les médias et les indicateurs comme facultatifs, car la visibilité à la source varie selon l’événement.
- Gardez extra.input_url pour rapprocher les résultats d’une requête à plusieurs URL ; une URL envoyée produit au plus un enregistrement d’événement.
- Un événement privé, supprimé, restreint ou réservé aux utilisateurs connectés peut se terminer sans enregistrement renvoyé.
API associées
En complément de la Facebook Event Details 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 Events Search API — Recherchez des événements publics par mot-clé avec leur programme, lieu, participation, média de couverture et état de l’événement.
- 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.