instagram/
profiles

Récupérez les profils Instagram publics d’un ou plusieurs noms d’utilisateur, avec identité, biographie, liens, indicateurs de compte et nombres visibles d’abonnés, d’abonnements et de publications, le tout normalisé.

Instagram Profiles API

Recherche par nom d’utilisateur connu
Métadonnées de profil
Instantanés de compte
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

Instagram Profiles

Les profils Instagram sont des pages de compte publiques réunissant noms d’utilisateur, noms affichés, biographies, images de profil, liens externes, catégories de compte, indicateurs de vérification et de confidentialité, ainsi que les nombres visibles d’abonnés, d’abonnements et de publications. Ces signaux d’identité, de classification et d’audience servent à enrichir des profils, à comparer des comptes, à tenir à jour des annuaires et à suivre l’évolution d’un compte à un instant donné.

Fonctionnalités de la Instagram Profiles API

  • Recherche par nom d’utilisateur connuRésolution d’un ou plusieurs noms d’utilisateur publics fournis, avec au plus un profil normalisé renvoyé pour chaque compte trouvé.
  • Identité et liens de profilRenvoie l’ID du compte, le nom d’utilisateur, le nom affiché, l’URL canonique du profil, l’image de profil, la biographie, l’URL externe et les liens publics de la biographie.
  • Classification et statut du compteConserve les statuts visibles de vérification et de confidentialité, ainsi que les signaux publics de catégorie, de compte d’entreprise et de compte professionnel.
  • Nombres visibles du profilRegroupe les nombres d’abonnés, d’abonnements et de publications sous metrics et horodate l’enregistrement normalisé avec collected_at.

Paramètres de la Instagram Profiles API

ParamètresObligatoireDescription
usernamesObligatoireListe obligatoire et non vide de noms d’utilisateur Instagram publics. Un @ initial est accepté et supprimé avant la recherche.

Comment utiliser la Instagram Profiles API

Envoyez les noms d’utilisateur connus sous forme de tâche asynchrone, interrogez son ID de tâche, puis lisez les profils publics résolus grâce à la pagination par curseur.

  1. Préparez un tableau usernames non vide contenant les comptes publics que vous connaissez déjà.
  2. Envoyez le tableau usernames en POST à /v1/instagram/profiles et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Après un succès, lisez data.results.items et transmettez results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/instagram/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram","@natgeo"]}'

# Poll GET /v1/tasks/{task_id}?limit=50
# Read data.results.items and continue with results.next_cursor while results.has_more is true

Cas d’usage de la Instagram Profiles API

  • Enrichissement de comptes connus : Ajoutez des ID stables, noms affichés, biographies, images de profil, URL canoniques et liens publics à des enregistrements qui contiennent déjà des noms d’utilisateur Instagram.
  • Comparaison de comptes sélectionnés : Comparez la vérification visible, la catégorie, les indicateurs de type de compte ainsi que les nombres d’abonnés, d’abonnements et de publications au sein d’une cohorte définie de noms d’utilisateur.
  • Suivi par instantanés de profil : Stockez collected_at avec les nombres de compte visibles issus de collectes répétées pour comparer des enregistrements de profil à un instant donné.

Conseils d’expert pour la Instagram Profiles API

  • Envoyez des noms d’utilisateur plutôt que des URL de profil ou des expressions de recherche, car cet endpoint n’accepte que le tableau usernames.
  • Supprimez les @ initiaux et dédoublonnez les identifiants obtenus avant l’envoi, afin que name et @name ne déclenchent pas deux recherches distinctes.
  • Rapprochez les noms d’utilisateur renvoyés de la liste envoyée : un compte indisponible, renommé ou inaccessible peut ne produire aucun profil.
  • Conservez les nombres et indicateurs de compte manquants comme des valeurs inconnues, au lieu de les convertir en zéro ou en false.
  • Stockez collected_at à côté de metrics lorsque vous comparez des instantanés de profil répétés.

En complément de la Instagram Profiles API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Instagram.

  • Instagram Followers Count API — Récupérez l’identité publique d’un profil et ses nombres visibles d’abonnés, d’abonnements et de publications.
  • Instagram Posts API — Collectez les publications publiques, médias, hashtags, mentions, horodatages et l’engagement par nom d’utilisateur.
  • Instagram Reels API — Collectez par nom d’utilisateur les Reels publics, médias, audio, hashtags, mentions et l’engagement.
  • Instagram Followers List API — Collectez les profils publics des abonnés avec le compte source et le contexte de la relation.
  • Instagram Following List API — Collectez les profils publics suivis par des comptes Instagram avec identité, contexte de la relation et nombres visibles du compte.
  • Instagram Account Age Checker API — Consultez la date d’arrivée d’un compte sur Instagram, le pays où il est basé, sa date de vérification et le nombre de changements de nom d’utilisateur.

Explorer d’autres plateformes

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

Instagram Profiles API — FAQ

Instagram Profiles API est une interface programmatique qui renvoie un profil public normalisé pour chaque nom d’utilisateur résolvable du tableau usernames obligatoire. Elle fournit l’identité, la biographie et les liens, les indicateurs de vérification et de confidentialité, les catégories de compte ainsi que les nombres visibles d’abonnés, d’abonnements et de publications.

Envoyez une ou plusieurs chaînes non vides dans usernames ; les valeurs peuvent commencer par un @. Les URL de profil, les requêtes par mot-clé, results_limit et les filtres de publications ne sont pas acceptés.

Un enregistrement peut contenir l’ID du compte, le nom d’utilisateur, le nom affiché, l’URL et l’image de profil, la biographie, les liens externes et de biographie, les indicateurs de vérification et de confidentialité, la catégorie, les signaux de compte d’entreprise et de compte professionnel, les nombres visibles et collected_at.

Un compte introuvable, renommé, indisponible ou inaccessible peut ne produire aucun enregistrement, et la disponibilité des sources publiques peut laisser certains champs vides. Les autres noms d’utilisateur valides de la même tâche peuvent tout de même renvoyer des profils.

Non. Il recherche les profils de noms d’utilisateur que vous connaissez déjà ; utilisez Instagram Search pour la découverte, et les endpoints Followers ou Following pour les membres d’une relation.

Chaque résultat de profil normalisé renvoyé coûte 0,6 crédit ; un nom d’utilisateur non résolu qui ne produit aucun résultat est couvert par la politique de résultat vide configurée.