instagram/
followers-list

Collectez les profils d’abonnés Instagram publics à partir d’un nom d’utilisateur, avec identité normalisée, images de profil, indicateurs de visibilité, contexte de la source, position et date de collecte.

Instagram Followers List API

Profils d’abonnés
Contexte de la source
Relations publiques
0,3 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 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ètresObligatoireDescription
usernamesObligatoireListe 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_limitFacultatifNombre 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.

  1. Préparez un ou plusieurs noms d’utilisateur Instagram publics ; un @ initial est accepté et supprimé avant la collecte.
  2. Envoyez usernames et, facultativement, results_limit en POST à /v1/instagram/followers-list, puis stockez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

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

Instagram Followers List API — FAQ

Instagram Followers List API est une interface programmatique qui récupère les profils publics visibles dans les listes d’abonnés des noms d’utilisateur Instagram envoyés. Elle renvoie, lorsqu’ils sont disponibles, l’identité normalisée, les images de profil, les indicateurs de visibilité, le contexte du compte source, la position dans la liste et la date de collecte.

usernames est obligatoire, sous forme de tableau non vide de chaînes non vides. results_limit est facultatif, vaut 100 par nom d’utilisateur par défaut et accepte les entiers de 1 à 2 000.

Un enregistrement peut contenir l’ID de profil, le nom d’utilisateur, le nom affiché, l’URL de profil dérivée, l’image de profil, les indicateurs de vérification et de confidentialité, la date de collecte, ainsi que des champs extra pour le nom d’utilisateur source, la relation et la position observée.

Non. Il renvoie des lignes de profils d’abonnés publics individuels ; utilisez Instagram Followers Count API pour obtenir les nombres agrégés visibles d’abonnés, d’abonnements et de publications d’un profil.

Non. Seules les relations visibles via la source publique prise en charge peuvent être renvoyées, et des comptes sources privés, indisponibles ou mal orthographiés peuvent ne produire aucune ligne.

results_limit est un maximum demandé, et non une garantie d’exhaustivité. La confidentialité des profils, la disponibilité des comptes, les limites de l’Actor, la pagination de la source et la limite actuelle des listes d’abonnés publiques peuvent réduire le nombre final.

Chaque profil d’abonné renvoyé coûte 0,3 crédit SocQ. L’estimation repose sur le nombre de noms d’utilisateur multiplié par results_limit, et un jeu de résultats vide n’entraîne aucun frais de résultat.