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ètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Liste 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.
- Préparez un tableau usernames non vide contenant les comptes publics que vous connaissez déjà.
- Envoyez le tableau usernames en POST à /v1/instagram/profiles et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- 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 trueCas 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.
API associées
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.
- Instagram Search API
- Instagram Comments API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API