instagram/
following-list

Collectez les profils publics suivis par des comptes Instagram, avec noms d’utilisateur normalisés, liens de profil, signaux de visibilité, contexte de la relation et nombres visibles.

Instagram Following List API

Relations d’abonnement
Profils publics
Noms d’utilisateur par lot
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 Following List

Les enregistrements d’Instagram Following List représentent les profils publics qu’un nom d’utilisateur source suit, avec identité normalisée, URL de profil, signaux de visibilité et contexte de la relation. Des collectes répétées permettent de constituer des instantanés de relations, tandis que collected_at, source_username et position indiquent quand et où chaque enregistrement a été observé.

Fonctionnalités de la Instagram Following List API

  • Noms d’utilisateur sources par lotEnvoyez un ou plusieurs noms d’utilisateur Instagram publics dans une seule tâche, sans le caractère @ initial.
  • Provenance de la relationConserve source_username, relationship et position dans extra afin de retracer chaque profil jusqu’à son compte source.
  • Identité de profil normaliséeRecevez l’ID de profil, le nom d’utilisateur, le nom affiché, l’URL canonique du profil, l’avatar et les signaux publics de vérification ou de confidentialité, lorsqu’ils sont disponibles.
  • Indicateurs de compte visiblesExploitez les nombres d’abonnés, d’abonnements et de publications renvoyés lorsque ces valeurs publiques figurent dans l’enregistrement collecté.
  • Pagination asynchrone des résultatsLancez la collecte hors du fil de la requête, interrogez l’état de la tâche et parcourez les résultats normalisés avec next_cursor.

Paramètres de la Instagram Following List API

ParamètresObligatoireDescription
usernamesObligatoireUn ou plusieurs noms d’utilisateur Instagram publics sans @, séparés par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal de profils suivis demandés par nom d’utilisateur source ; un entier de 1 à 2 000, 100 par défaut.

Comment utiliser la Instagram Following List API

Envoyez des noms d’utilisateur publics sous forme de tâche asynchrone, interrogez l’ID de tâche renvoyé, puis lisez les profils suivis normalisés avec la pagination par curseur.

  1. Préparez un ou plusieurs noms d’utilisateur Instagram publics, sans le caractère @ initial.
  2. Envoyez usernames et, facultativement, un results_limit de 1 à 2 000 en POST à /v1/instagram/following-list.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. Lisez /v1/tasks/{task_id}?limit=50 et continuez avec results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/instagram/following-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 GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

Cas d’usage de la Instagram Following List API

  • Cartographie de réseaux de créateurs : Constituez des cartes consultables des créateurs, éditeurs et organisations publics que suivent des comptes choisis.
  • Étude des comptes de marque : Comparez les relations d’abonnement visibles entre comptes de marque, de campagne, régionaux ou concurrents.
  • Repérage de partenariats : Identifiez les profils publics qui apparaissent dans les listes d’abonnements de comptes pertinents pour un programme de partenariat.
  • Enrichissement d’annuaires de profils : Ajoutez URL canoniques, noms affichés, avatars, signaux de compte et provenance de la relation à vos annuaires internes.
  • Suivi des changements de relations : Stockez des instantanés horodatés et comparez les ID de profil stables d’une exécution à l’autre pour passer en revue les ajouts ou les retraits.

Conseils d’expert pour la Instagram Following List API

  • Retirez le @ initial de chaque nom d’utilisateur avant l’envoi ; l’entrée du fournisseur est normalisée en noms d’utilisateur simples.
  • Commencez avec un results_limit ciblé et ne l’augmentez que si le workflow exige un ensemble de relations visibles plus large.
  • Stockez l’ID de profil avec extra.source_username, car un même profil suivi peut apparaître pour plusieurs comptes sources.
  • Considérez l’absence d’avatars, d’indicateurs de compte, de signaux de vérification ou de positions comme une variabilité normale des résultats publics.
  • Prévoyez des résultats vides ou partiels, car les relations privées, restreintes, supprimées ou réservées aux comptes connectés sortent du périmètre pris en charge.

En complément de la Instagram Following 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 Followers List API — Collectez les profils publics des abonnés avec le compte source et le contexte de la relation.
  • 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 Following List API — FAQ

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

Following renvoie des profils publics individuels issus d’une relation d’abonnement visible, tandis que Followers Count renvoie les totaux d’audience et de publications au niveau du profil, sans liste de relations.

Les enregistrements peuvent comprendre l’ID, le nom d’utilisateur, le nom affiché, l’URL du profil, l’URL de l’avatar, les signaux de vérification et de confidentialité, les indicateurs visibles, collected_at, source_username, relationship et position.

Oui. Envoyez un ou plusieurs noms d’utilisateur publics dans le tableau usernames ; source_username indique quel compte d’entrée a produit chaque enregistrement de relation, lorsque ce champ est disponible.

Seules les relations visibles de profils publics peuvent être renvoyées. Les données de relation privées, restreintes, supprimées ou réservées aux comptes connectés peuvent produire des résultats partiels ou vides.

Lisez la tâche terminée avec un limit allant jusqu’à 500 enregistrements par page, puis transmettez results.next_cursor à la requête suivante tant que results.has_more vaut true.

Les résultats normalisés réussis sont facturés 0,3 crédit par enregistrement, sans frais de base ; un résultat vide relève de la politique de base seule et coûte donc zéro crédit.