Instagram Followers List
Les abonnés Instagram sont des enregistrements de relation publics, correspondant aux profils visibles dans la liste d’abonnés d’un nom d’utilisateur envoyé, avec identité, image de profil, indicateurs de vérification et de confidentialité, contexte de la source, position et date de collecte. Ces champs servent à échantillonner une audience, à vérifier les recoupements entre comptes, à sélectionner des profils et à étudier les listes de relations.
Fonctionnalités de la Instagram Followers List API
- Collecte d’abonnés multi-comptesEnvoyez un ou plusieurs noms d’utilisateur Instagram et demandez les profils d’abonnés de chaque compte source dans une seule tâche asynchrone.
- Identité d’abonné normaliséeRenvoie, pour chaque ligne d’abonné, l’ID de profil, le nom d’utilisateur, le nom affiché, l’URL de profil dérivée et l’image de profil publique, lorsqu’ils sont disponibles.
- Signaux de visibilité et de sourceConserve les indicateurs de vérification et de compte privé, ainsi que le nom d’utilisateur source et la relation d’abonnement lorsque ces valeurs sont exposées.
- Contexte de liste observéGarde la position dans la source et l’heure de scraping de l’Actor lorsqu’elles sont disponibles, avec la date de collecte SocQ comme horodatage de repli.
- Contrôle des résultats par nom d’utilisateurApplique results_limit séparément à chaque nom d’utilisateur envoyé, avec 100 par défaut et une plage acceptée de 1 à 2 000.
Paramètres de la Instagram Followers List API
| Paramètres | Obligatoire | Description |
|---|---|---|
usernames | Obligatoire | Liste obligatoire et non vide de noms d’utilisateur Instagram. Chaque élément doit être une chaîne non vide ; les @ initiaux sont supprimés avant la collecte. |
results_limit | Facultatif | Nombre maximal de profils d’abonnés demandés par nom d’utilisateur ; 100 par défaut, entiers de 1 à 2 000 acceptés. |
Comment utiliser la Instagram Followers List API
Envoyez des noms d’utilisateur Instagram publics, suivez la tâche asynchrone et parcourez les profils d’abonnés normalisés une fois la collecte réussie.
- Préparez un ou plusieurs noms d’utilisateur Instagram publics ; un @ initial est accepté et supprimé avant la collecte.
- Envoyez usernames et, facultativement, results_limit en POST à /v1/instagram/followers-list, puis stockez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
- Lisez data.results.items et suivez next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/instagram/followers-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Instagram Followers List API
- Échantillonnage d’audience publique : Constituez un échantillon borné de noms d’utilisateur d’abonnés, noms affichés, liens de profil, indicateurs de visibilité et positions observées pour un compte public choisi.
- Recoupement entre comptes : Regroupez les lignes par extra.source_username et comparez les ID ou noms d’utilisateur des abonnés pour repérer les profils présents sous plus d’un compte envoyé.
- Files d’enrichissement de profils : Sélectionnez des noms d’utilisateur renvoyés et transmettez-les à Instagram Profiles lorsqu’un workflow a besoin de la biographie ou des nombres visibles du profil.
- Instantanés de listes de relations : Stockez l’identité de l’abonné, le nom d’utilisateur source, la position observée et collected_at pour distinguer les échantillons de listes publiques collectés plus tard.
Conseils d’expert pour la Instagram Followers List API
- Avec plusieurs noms d’utilisateur, estimez la profondeur demandée comme le nombre de noms multiplié par results_limit, car le plafond et l’estimation de crédits s’appliquent par compte source.
- Si un nom d’utilisateur source commence par @, vous pouvez l’envoyer tel quel ; le mappeur du fournisseur supprime les @ initiaux avant l’exécution de l’Actor.
- Pour comparer des comptes, conservez extra.source_username : un même profil d’abonné peut figurer dans plusieurs listes sources, et la déduplication entre sources n’est pas garantie.
- Si position est présent, voyez-y une valeur observée dans la liste, et non un classement stable ni une mesure de la force de la relation.
- Lorsqu’une source publique renvoie moins de lignes que demandé, gardez le résultat partiel et notez collected_at ; la confidentialité, la disponibilité du compte, la pagination de la source et les limites de l’Actor peuvent réduire la sortie.
API associées
En complément de la Instagram Followers List 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 Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, liens, indicateurs de compte, catégories et nombres visibles.
- 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 Similar Accounts API — Listez les comptes qu’Instagram suggère comme similaires à un nom d’utilisateur, avec noms d’utilisateur, noms, avatars et statut de vérification.
- Instagram Post Likers API — Listez les comptes de la liste visible des personnes ayant aimé une publication à partir de son URL, avec noms d’utilisateur, noms, avatars et statut de vérification.
- Instagram Reels API
- 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 Comment Replies API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API