facebook/
profile-photos

Collectez les photos publiques de profils et de Pages Facebook à partir d’une ou plusieurs URL et obtenez légendes, contexte de l’auteur, engagement, métadonnées d’image et liens sources sous forme d’enregistrements normalisés.

Facebook Profile Photos API

Photos de profils
Métadonnées d’image
Données publiques
0,5 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 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ètresObligatoireDescription
urlsObligatoireURL de profils ou de Pages Facebook publics, séparées par des virgules ou des retours à la ligne.
results_limitFacultatifNombre 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.

  1. Préparez une ou plusieurs URL de profils ou de Pages Facebook publics.
  2. Envoyez urls, avec results_limit en option, en POST à /v1/facebook/profile-photos.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  4. 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.

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.

Explorer d’autres plateformes

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

Facebook Profile Photos API — FAQ

Facebook Profile Photos API est une interface programmatique qui organise le fil de photos public d’un profil ou d’une Page Facebook donnés en enregistrements de médias homogènes, ce qui simplifie l’inventaire en masse et le suivi dans la durée. Ces enregistrements servent à l’étude des contenus visuels et à la surveillance de profils, avec une couverture limitée aux contenus accessibles par le fil de photos public de la cible.

Utilisez des profils ou des Pages publics sur facebook.com, www.facebook.com ou m.facebook.com. La validation ne contrôle que l’hôte : une autre ressource Facebook peut donc ne renvoyer aucun fil de photos.

Un enregistrement peut contenir l’ID de la photo, l’URL canonique, le texte de la légende, le contexte public brut de l’auteur, les métriques visibles, les URL et dimensions des médias, created_at, collected_at et extra.input_url.

Réglez results_limit de 20 à 2 000 ; la valeur par défaut est 100. La limite s’applique séparément à chaque URL envoyée, et un fil peut se terminer avant de l’atteindre.

Les photos privées, restreintes, supprimées, réservées aux utilisateurs connectés ou indisponibles ne sont pas renvoyées. La structure des albums, les commentaires, les personnes identifiées, le détail complet des réactions et le téléchargement des fichiers originaux ne sont pas garantis.

Chaque photo enregistrée coûte 0,5 crédit, sans frais de base par tâche. Les estimations multiplient la limite de résultats par URL par le nombre d’URL envoyées.