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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Uno o più nomi utente pubblici di Instagram senza @, separati da virgole o da a capo. |
results_limit | Facoltativo | Numero 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.
- Prepara uno o più nomi utente pubblici di Instagram senza il carattere @ iniziale.
- Invia con POST usernames e un results_limit facoltativo da 1 a 2.000 a /v1/instagram/following-list.
- Interroga /v1/tasks/{task_id} finché lo status è succeeded o failed.
- 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_cursorCasi 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.
API correlate
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.
- 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