facebook/
profile-events

Collectez les événements publics associés à des URL de profils ou de Pages Facebook et obtenez, en enregistrements normalisés, noms, descriptions, programmes, lieux, médias, indicateurs visibles et contexte de la source.

Facebook Profile Events API

Événements de profils
URL par lot
Données publiques
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 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ètresObligatoireDescription
urlsObligatoireUne ou plusieurs URL de profils ou de Pages Facebook sur facebook.com, www.facebook.com ou m.facebook.com.
results_limitFacultatifNombre 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.

  1. 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.
  2. Envoyez urls, avec results_limit en option, en POST à /v1/facebook/profile-events.
  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/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.

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.

Explorer d’autres plateformes

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

Facebook Profile Events API — FAQ

Facebook Profile Events API est une interface programmatique qui rassemble les événements publics associés à un profil ou à une Page Facebook donnés, sans qu’il faille localiser chaque événement séparément. Elle sert aux calendriers d’organisateurs, aux inventaires d’événements et aux comparaisons entre Pages ; sa cible est une source d’événements publique, et non l’URL d’un événement isolé.

Envoyez une ou plusieurs URL hébergées sur facebook.com, www.facebook.com ou m.facebook.com. La validation ne vérifie que l’hôte : utilisez donc des profils ou des Pages adaptés à un flux d’événements public.

results_limit vaut 100 par défaut et accepte les entiers de 20 à 2 000. La limite s’applique séparément à chaque URL envoyée, et la collecte d’une source peut s’arrêter plus tôt lorsqu’il n’y a plus d’événements publics.

Un hôte Facebook valide ne garantit pas que la cible expose un flux d’événements public pris en charge. Des événements indisponibles, supprimés, anciens, privés ou réservés aux utilisateurs connectés peuvent aussi être absents.

Interrogez l’ID de tâche renvoyé jusqu’à ce que son statut soit succeeded, puis lisez les événements enregistrés depuis l’endpoint de résultats de la tâche.

L’utilisation coûte 0,6 crédit pour chaque événement enregistré, sans frais de base par tâche. Un résultat terminé mais vide n’entraîne donc aucun frais lié aux résultats.