Facebook Profile Photos
Les photos de profils Facebook sont des images publiques du fil d’un profil ou d’une Page, avec légendes, contexte de l’auteur, engagement visible, dimensions et liens sources. Ces enregistrements servent à inventorier des médias, à étudier les contenus visuels et à surveiller un profil précis.
Fonctionnalités de la Facebook Profile Photos API
- Fils de photos de plusieurs profilsCollecte les photos publiques d’une ou plusieurs URL de profils ou de Pages Facebook, la limite demandée s’appliquant séparément à chaque entrée.
- Métadonnées d’image normaliséesRenvoie les URL d’images, les miniatures, la largeur, la hauteur et la durée, avec les ID de photos et les liens canoniques.
- Contexte de la photo et de la sourceConserve les légendes, les données publiques de l’auteur, l’engagement visible, les horodatages et extra.input_url pour l’analyse et l’attribution de la source.
- Parcours du fil par curseurSuit les curseurs du fil de photos public et supprime les doublons par ID stable, URL ou identité d’image avant d’atteindre la limite par entrée.
Paramètres de la Facebook Profile Photos API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL de profils ou de Pages Facebook publics, séparées par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre maximal de photos à collecter par URL d’entrée, de 20 à 2 000 ; la valeur par défaut est 100. |
Comment utiliser la Facebook Profile Photos API
Envoyez des URL de profils ou de Pages publics sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les photos normalisées grâce à la pagination par curseur des résultats.
- Préparez une ou plusieurs URL de profils ou de Pages Facebook publics.
- Envoyez urls, avec results_limit en option, en POST à /v1/facebook/profile-photos.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez /v1/tasks/{task_id}?limit=50 et transmettez results.next_cursor tant qu’il reste des photos enregistrées.
curl -X POST "https://api.socq.ai/v1/facebook/profile-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'
# 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 Photos API
- Inventaire de médias publics : Rangez ID de photos, liens canoniques, URL d’images, dimensions, légendes et entrées sources dans un index d’actifs propre à chaque profil.
- Étude des contenus visuels : Comparez légendes, métadonnées d’image, horodatages et engagement visible pour étudier les habitudes de publication de photos publiques.
- Surveillance des photos d’un profil : Répétez les collectes sur des URL de profils ou de Pages choisis et croisez l’identité de la photo avec extra.input_url pour repérer les nouveaux enregistrements exposés.
Conseils d’expert pour la Facebook Profile Photos API
- Utilisez des URL de profils et de Pages en facebook.com, www.facebook.com ou m.facebook.com qui exposent un fil de photos public ; la seule validation de l’hôte ne garantit pas que la ressource visée convienne.
- Fixez results_limit en pensant au nombre d’URL d’entrée, car la limite de 20 à 2 000 s’applique indépendamment à chaque URL.
- En combinant plusieurs collectes, dédoublonnez par id de photo, URL ou identité d’image avec extra.input_url, afin de conserver le bon profil source.
- Considérez les légendes, les champs d’auteur, les métriques, les horodatages et les dimensions comme facultatifs, et vérifiez que le média contient une URL d’image avant de l’afficher ou de le télécharger.
API associées
En complément de la Facebook Profile Photos API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook.
- Facebook Posts API — Collectez les publications publiques, médias, réactions, commentaires et partages à partir d’URL Facebook prises en charge.
- 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 Group Posts API — Collectez les publications publiques à partir d’URL de groupes Facebook avec tri au choix, limites par groupe, contexte de l’auteur, médias vidéo et engagement visible.
- Facebook Ad Transcript API — Extrayez le texte parlé disponible, la langue, le format et le contexte source à partir d’URL de la Facebook Ad Library.
- 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.
- 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.