Instagram Followers List
I follower di Instagram sono record pubblici di relazione per i profili visibili nell’elenco dei follower di un nome utente inviato, con identità, immagine del profilo, flag di verifica e privacy, contesto di origine, posizione e momento di raccolta. Questi campi supportano il campionamento del pubblico, i controlli di sovrapposizione tra account, la selezione dei profili e la ricerca sugli elenchi di relazioni.
Funzionalità della Instagram Followers List API
- Raccolta dei follower di più accountInvia uno o più nomi utente Instagram e richiedi i profili dei follower di ogni account di origine in un’unica attività asincrona.
- Identità dei follower normalizzataRestituisce, per ogni riga di follower, ID del profilo, nome utente, nome visualizzato, URL del profilo derivato e immagine pubblica del profilo, se disponibili.
- Segnali di visibilità e di origineConserva i flag di verifica e di account privato, oltre al nome utente di origine e alla relazione di follower, quando questi valori sono esposti.
- Contesto osservato dell’elencoMantiene la posizione di origine e l’orario di scraping dell’Actor, quando disponibili, con il momento di raccolta di SocQ come timestamp di riserva.
- Controllo dei risultati per nome utenteApplica results_limit separatamente a ogni nome utente inviato, con un valore predefinito di 100 e un intervallo accettato da 1 a 2.000.
Parametri della Instagram Followers List API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Elenco obbligatorio e non vuoto di nomi utente Instagram. Ogni elemento deve essere una stringa non vuota; le @ iniziali vengono rimosse prima della raccolta. |
results_limit | Facoltativo | Numero massimo di profili di follower richiesti per nome utente; il valore predefinito è 100 e accetta interi da 1 a 2.000. |
Come usare la Instagram Followers List API
Invia nomi utente pubblici di Instagram, segui l’attività asincrona e scorri i record dei profili dei follower normalizzati quando la raccolta ha successo.
- Prepara uno o più nomi utente pubblici di Instagram; una @ iniziale viene accettata e rimossa prima della raccolta.
- Invia con POST usernames e un results_limit facoltativo a /v1/instagram/followers-list, poi conserva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
- Leggi data.results.items e segui next_cursor finché has_more è 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 trueCasi d’uso della Instagram Followers List API
- Campionamento del pubblico di un account: Costruisci un campione circoscritto di nomi utente dei follower, nomi visualizzati, link ai profili, flag di visibilità e posizioni osservate per un account pubblico selezionato.
- Controlli di sovrapposizione tra account: Raggruppa le righe per extra.source_username e confronta gli ID o i nomi utente dei follower per individuare i profili presenti sotto più di un account inviato.
- Code di arricchimento dei profili: Seleziona i nomi utente restituiti e passali a Instagram Profiles quando un flusso di lavoro richiede biografia o conteggi visibili del profilo.
- Istantanee degli elenchi di relazioni: Salva identità del follower, nome utente di origine, posizione osservata e collected_at per distinguere i campioni successivi dell’elenco pubblico.
Consigli degli esperti per la Instagram Followers List API
- Quando invii più nomi utente, stima la profondità richiesta come numero di nomi utente moltiplicato per results_limit, perché il limite e la stima dei crediti si applicano a ogni account di origine.
- Se un nome utente di origine inizia con @, puoi inviarlo senza modifiche: il mapper del provider rimuove le @ iniziali prima dell’esecuzione dell’Actor.
- Quando confronti gli account, conserva extra.source_username, perché lo stesso profilo di follower può comparire in più elenchi di origine e la deduplicazione tra origini non è garantita.
- Se position è presente, trattalo come un valore osservato dell’elenco e non come una classifica stabile o una misura della forza della relazione.
- Quando una fonte pubblica restituisce meno righe di quelle richieste, mantieni il risultato parziale e registra collected_at; privacy, disponibilità dell’account, paginazione della fonte e limiti dell’Actor possono ridurre l’output.
API correlate
Oltre alla Instagram Followers 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 Following List API — Raccoglie i profili pubblici seguiti dagli account Instagram con identità, contesto della relazione e conteggi visibili dell’account.
- 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