Facebook Profiles
Les profils et Pages Facebook sont des surfaces d’identité publiques, avec noms, texte de bio ou de présentation, avatars, liens canoniques et compteurs visibles d’audience ou d’activité. Ces champs d’identité et ces signaux publics servent à enrichir des URL, à rapprocher des entités, à prendre des instantanés de métadonnées et à mener des études comparatives.
Fonctionnalités de la Facebook Profiles API
- Consultation directe d’URL connuesEnvoyez plusieurs URL de profils ou de Pages Facebook publics et recevez, au plus, un enregistrement de profil normalisé pour chaque entrée.
- Champs d’identité normalisésRenvoie l’ID Facebook, l’URL canonique, le nom affiché, le type d’enregistrement et l’URL d’entrée d’origine dans une structure homogène.
- Présentation publique du profilRécupère la bio, l’introduction, la description ou le texte de présentation publics, avec l’avatar du profil ou de la Page lorsqu’il est disponible.
- Compteurs de profil visiblesNormalise les compteurs publics courants d’abonnés, d’abonnements, de publications, de mentions « J’aime », de commentaires, de vues, de lectures et de partages exposés par la cible.
Paramètres de la Facebook Profiles API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL obligatoires de profils ou de Pages Facebook publics. Les hôtes acceptés sont facebook.com, www.facebook.com et m.facebook.com ; séparez plusieurs valeurs par des virgules ou des retours à la ligne. |
Comment utiliser la Facebook Profiles API
Envoyez des URL de profils ou de Pages sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les profils normalisés.
- Préparez une ou plusieurs URL de profils ou de Pages publics sur facebook.com, www.facebook.com ou m.facebook.com.
- Envoyez urls en POST à /v1/facebook/profiles.
- 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/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"]}'
# 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 Profiles API
- Enrichissement d’un catalogue de profils et de Pages : Ajoutez ID normalisés, noms, liens canoniques, textes de bio, avatars et compteurs visibles à un catalogue d’URL Facebook connues.
- Rapprochement d’identités à partir d’URL connues : Servez-vous des ID, des URL canoniques, des noms et d’extra.input_url renvoyés pour relier les liens envoyés à vos fiches d’entités existantes.
- Instantanés de métadonnées publiques : Stockez collected_at avec le texte de profil, l’avatar et les compteurs disponibles pour comparer les métadonnées publiques d’une collecte à l’autre.
Conseils d’expert pour la Facebook Profiles API
- Vérifiez que chaque URL mène bien au profil ou à la Page voulus, car la validation de la requête contrôle l’hôte Facebook mais pas le chemin de la ressource.
- Gardez extra.input_url pour rapprocher les résultats d’une tâche à plusieurs URL, puisque des entrées en double ou indisponibles peuvent donner moins d’enregistrements que d’URL envoyées.
- Traitez les noms, le texte de profil, les avatars et chaque valeur d’indicateur comme nullables, car les profils personnels et les Pages n’exposent pas les mêmes champs publics.
- Passez par l’endpoint de contenu Facebook correspondant lorsque vous voulez des publications, des photos, des Reels, des événements ou des avis plutôt que des métadonnées de profil.
API associées
En complément de la Facebook Profiles 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 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.
- Facebook Profile Photos API — Collectez les photos publiques à partir d’URL de profils ou de Pages avec légendes, contexte de l’auteur, engagement, métadonnées d’image et références sources.
- Facebook Reels API — Collectez les Reels publics à partir d’URL de profils ou de Pages avec légendes, contexte de l’auteur, métadonnées vidéo, engagement visible et références sources.