instagram/
followers-list

Raccogli i profili dei follower pubblici di Instagram per nome utente, con identità normalizzata, immagini del profilo, flag di visibilità, contesto di origine, posizione e momento di raccolta.

Instagram Followers List API

Profili dei follower
Contesto di origine
Relazioni pubbliche
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 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

ParametriObbligatorioDescrizione
usernamesObbligatorioElenco obbligatorio e non vuoto di nomi utente Instagram. Ogni elemento deve essere una stringa non vuota; le @ iniziali vengono rimosse prima della raccolta.
results_limitFacoltativoNumero 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.

  1. Prepara uno o più nomi utente pubblici di Instagram; una @ iniziale viene accettata e rimossa prima della raccolta.
  2. Invia con POST usernames e un results_limit facoltativo a /v1/instagram/followers-list, poi conserva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
  4. 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 true

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

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.

Esplora altre piattaforme

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

Instagram Followers List API — FAQ

Instagram Followers List API è un’interfaccia programmatica per recuperare i record dei profili pubblici visibili negli elenchi dei follower dei nomi utente Instagram inviati. Restituisce, quando disponibili, identità normalizzata, immagini del profilo, flag di visibilità, contesto dell’account di origine, posizione nell’elenco e momento di raccolta.

usernames è obbligatorio come array non vuoto di stringhe non vuote. results_limit è facoltativo, ha come valore predefinito 100 per nome utente e accetta interi da 1 a 2.000.

Un record può contenere ID del profilo, nome utente, nome visualizzato, URL del profilo derivato, immagine del profilo, flag di verifica e privacy, momento di raccolta e campi extra per nome utente di origine, relazione e posizione osservata.

No. Restituisce le singole righe dei profili pubblici dei follower; usa Instagram Followers Count API quando ti servono i totali visibili di follower, seguiti e post di un profilo.

No. Possono essere restituite solo le relazioni visibili tramite la fonte pubblica supportata e gli account di origine privati, non disponibili o scritti in modo errato possono non produrre alcuna riga.

results_limit è un massimo richiesto e non una garanzia di completezza. Privacy del profilo, disponibilità dell’account, limiti dell’Actor, paginazione della fonte e l’attuale confine dell’elenco pubblico dei follower possono ridurre il numero finale.

Ogni profilo di follower restituito costa 0,3 crediti SocQ. La stima usa il numero di nomi utente moltiplicato per results_limit e un insieme di risultati vuoto non ha alcun costo per i risultati.