instagram/
following-list

Raccogli i profili pubblici seguiti dagli account Instagram, con nomi utente normalizzati, link ai profili, segnali di visibilità, contesto della relazione e conteggi visibili.

Instagram Following List API

Relazioni di following
Profili pubblici
Nomi utente in batch
0,3 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Instagram Following List

I record di Instagram Following List rappresentano i profili pubblici seguiti da un nome utente di origine, con identità normalizzata, URL dei profili, segnali di visibilità e contesto della relazione. Le raccolte ripetute possono supportare istantanee delle relazioni, mentre collected_at, source_username e position conservano quando e dove ogni record è stato osservato.

Funzionalità della Instagram Following List API

  • Nomi utente di origine in batchInvia uno o più nomi utente pubblici di Instagram in un’unica attività, senza il carattere @ iniziale.
  • Provenienza della relazioneMantiene source_username, relationship e position in extra, così ogni profilo può essere ricondotto al suo account di origine.
  • Identità del profilo normalizzataRicevi ID del profilo, nome utente, nome visualizzato, URL canonico del profilo, avatar e segnali pubblici di verifica o privacy, quando disponibili.
  • Metriche visibili dell’accountUsa i conteggi restituiti di follower, seguiti e post quando questi valori pubblici sono presenti nel record raccolto.
  • Paginazione asincrona dei risultatiInvia il lavoro di raccolta fuori dal thread della richiesta, interroga lo stato dell’attività e scorri i risultati normalizzati con next_cursor.

Parametri della Instagram Following List API

ParametriObbligatorioDescrizione
usernamesObbligatorioUno o più nomi utente pubblici di Instagram senza @, separati da virgole o da a capo.
results_limitFacoltativoNumero massimo di profili seguiti richiesti per nome utente di origine; un intero da 1 a 2.000, con valore predefinito 100.

Come usare la Instagram Following List API

Invia nomi utente pubblici come attività asincrona, interroga l’ID attività restituito e leggi i profili seguiti normalizzati con la paginazione a cursore.

  1. Prepara uno o più nomi utente pubblici di Instagram senza il carattere @ iniziale.
  2. Invia con POST usernames e un results_limit facoltativo da 1 a 2.000 a /v1/instagram/following-list.
  3. Interroga /v1/tasks/{task_id} finché lo status è succeeded o failed.
  4. Leggi /v1/tasks/{task_id}?limit=50 e prosegui con results.next_cursor quando has_more è 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

Casi d’uso della Instagram Following List API

  • Mappatura della rete dei creator: Costruisci mappe verificabili di quali creator, editori e organizzazioni pubblici seguono gli account selezionati.
  • Ricerca sugli account dei brand: Confronta le relazioni di following visibili tra account di brand, campagne, aree geografiche o concorrenti.
  • Scoperta di partnership: Individua i profili pubblici che compaiono negli elenchi dei seguiti degli account rilevanti per un programma di partnership.
  • Arricchimento di directory di profili: Aggiungi alle directory interne URL canonici, nomi visualizzati, avatar, segnali dell’account e provenienza della relazione.
  • Tracciamento dei cambiamenti nelle relazioni: Salva istantanee con timestamp e confronta gli ID stabili dei profili tra le esecuzioni per verificare aggiunte o rimozioni.

Consigli degli esperti per la Instagram Following List API

  • Rimuovi la @ iniziale da ogni nome utente prima dell’invio; l’input del provider viene normalizzato in semplici nomi utente.
  • Parti da un results_limit mirato e aumentalo solo quando il flusso di lavoro richiede un insieme di relazioni visibili più ampio.
  • Salva l’ID del profilo insieme a extra.source_username, perché lo stesso profilo seguito può comparire per più account di origine.
  • Considera avatar, metriche dell’account, segnali di verifica o posizioni mancanti come normale variabilità dei risultati pubblici.
  • Progetta per risultati vuoti o parziali, perché le relazioni private, limitate, rimosse o visibili solo con l’accesso sono fuori dal confine supportato.

Oltre alla Instagram Following List API, usa queste API quando ti serve un altro tipo di dati pubblici di Instagram.

  • Instagram Followers Count API — Recupera l’identità del profilo pubblico e i conteggi visibili di follower, seguiti e post.
  • Instagram Posts API — Raccoglie post pubblici, media, hashtag, menzioni, date ed engagement a partire dal nome utente.
  • Instagram Profiles API — Recupera identità del profilo pubblico, bio, link, flag dell’account, categorie e conteggi visibili a partire dal nome utente.
  • Instagram Followers List API — Raccoglie i record dei profili follower pubblici con contesto dell’account di origine e della relazione.
  • Instagram Similar Accounts API — Elenca gli account che Instagram suggerisce come simili a un nome utente, con nomi utente, nomi, avatar e stato di verifica.
  • Instagram Post Likers API — Elenca gli account dell’elenco visibile di chi ha messo Mi piace a un post a partire dal suo URL, con nomi utente, nomi, avatar e stato di verifica.

Esplora altre piattaforme

Combina i dati di Instagram con i dati pubblici delle altre piattaforme social supportate.

Instagram Following List API — FAQ

Instagram Following List API è un’interfaccia programmatica per recuperare i record dei profili pubblici visibili negli elenchi dei seguiti dei nomi utente Instagram inviati. Restituisce identità normalizzata, URL dei profili, segnali di visibilità, contesto dell’account di origine, posizione nell’elenco e metriche dell’account disponibili.

Following restituisce i singoli record dei profili pubblici da una relazione di following visibile, mentre Followers Count restituisce i totali di pubblico e di post a livello di profilo, senza un elenco di relazioni.

I record possono includere ID, nome utente, nome visualizzato, URL del profilo, URL dell’avatar, segnali di verifica e privacy, metriche visibili, collected_at, source_username, relationship e position.

Sì. Invia uno o più nomi utente pubblici nell’array usernames; source_username indica quale account di input ha prodotto ogni record di relazione, quando quel campo è disponibile.

Possono essere restituite solo le relazioni visibili per i profili pubblici. I dati di relazione privati, limitati, rimossi o visibili solo con l’accesso possono produrre risultati parziali o vuoti.

Leggi l’attività completata con un limit fino a 500 record per pagina, poi passa results.next_cursor nella richiesta successiva finché results.has_more è true.

I risultati normalizzati riusciti sono fatturati a 0,3 crediti per record, senza costo base; un risultato vuoto usa la policy con sola base e quindi costa zero crediti.