instagram/
profiles

Recupera i profili Instagram pubblici di uno o più nomi utente, con identità normalizzata, biografie, link, flag dell’account e numero visibile di follower, seguiti e post.

Instagram Profiles API

Ricerca per nome utente noto
Metadati del profilo
Istantanee dell’account
0,6 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 Profiles

I profili Instagram sono pagine pubbliche di account con nome utente, nome visualizzato, biografia, immagine del profilo, link esterni, categorie dell’account, segnali di verifica e privacy, oltre al numero visibile di follower, seguiti e post. Questi segnali di identità, classificazione e pubblico supportano l’arricchimento dei profili, il confronto tra account, la manutenzione di directory e il monitoraggio puntuale nel tempo.

Funzionalità della Instagram Profiles API

  • Ricerca per nome utente notoRisolve uno o più nomi utente pubblici forniti e restituisce al massimo un record di profilo normalizzato per ogni account trovato.
  • Identità e link del profiloRestituisce ID account, nome utente, nome visualizzato, URL canonico del profilo, immagine del profilo, biografia, URL esterno e link pubblici della biografia.
  • Classificazione e stato dell’accountConserva lo stato visibile di verifica e privacy insieme ai segnali pubblici di categoria, account business e account professionale.
  • Conteggi visibili del profiloRaggruppa follower, seguiti e post sotto metrics e aggiunge al record normalizzato il timestamp collected_at.

Parametri della Instagram Profiles API

ParametriObbligatorioDescrizione
usernamesObbligatorioElenco obbligatorio e non vuoto di nomi utente Instagram pubblici. Una @ iniziale viene accettata e rimossa prima della ricerca.

Come usare la Instagram Profiles API

Invia i nomi utente noti come attività asincrona, interroga il relativo ID attività e leggi i record dei profili pubblici risolti con la paginazione a cursore.

  1. Prepara un array usernames non vuoto con gli account pubblici che già conosci.
  2. Invia con POST l’array usernames a /v1/instagram/profiles e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché status diventa succeeded o failed.
  4. Dopo il successo leggi data.results.items e passa results.next_cursor quando results.has_more è true.
curl -X POST "https://api.socq.ai/v1/instagram/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram","@natgeo"]}'

# Poll GET /v1/tasks/{task_id}?limit=50
# Read data.results.items and continue with results.next_cursor while results.has_more is true

Casi d’uso della Instagram Profiles API

  • Arricchimento di account noti: Aggiungi ID stabili, nomi visualizzati, biografie, immagini del profilo, URL canonici e link pubblici ai record che contengono già nomi utente Instagram.
  • Confronto tra account selezionati: Confronta verifica visibile, categoria, segnali sul tipo di account e numero di follower, seguiti e post all’interno di un gruppo definito di nomi utente.
  • Monitoraggio delle istantanee dei profili: Salva collected_at insieme ai conteggi visibili dell’account da raccolte ripetute per confrontare i record del profilo in momenti diversi.

Consigli degli esperti per la Instagram Profiles API

  • Invia nomi utente e non URL di profili o frasi di ricerca, perché questo endpoint accetta solo l’array usernames.
  • Rimuovi le @ iniziali e deduplica gli handle prima dell’invio, così name e @name non generano ricerche separate.
  • Confronta i nomi utente restituiti con l’elenco di input, perché un account non disponibile, rinominato o inaccessibile può non produrre alcun record di profilo.
  • Conserva i conteggi e i flag dell’account mancanti come valori sconosciuti invece di convertirli in zero o false.
  • Salva collected_at accanto a metrics quando confronti istantanee ripetute del profilo.

Oltre alla Instagram Profiles 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 Reels API — Raccoglie Reels pubblici, media, audio, hashtag, menzioni ed engagement 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 Following List API — Raccoglie i profili pubblici seguiti dagli account Instagram con identità, contesto della relazione e conteggi visibili dell’account.
  • Instagram Account Age Checker API — Scopri quando un account si è iscritto a Instagram, il paese in cui si trova, quando è stato verificato e quante volte ha cambiato nome utente.

Esplora altre piattaforme

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

Instagram Profiles API — FAQ

Instagram Profiles API è un’interfaccia programmatica che recupera un profilo pubblico normalizzato per ogni nome utente risolvibile nell’array usernames obbligatorio. Restituisce identità, biografia e link, flag di verifica e privacy, categorie dell’account e il numero visibile di follower, seguiti e post.

Invia una o più stringhe non vuote in usernames; i valori possono includere una @ iniziale. URL dei profili, query per parola chiave, results_limit e filtri sui post non sono accettati.

Un record può includere ID account, nome utente, nome visualizzato, URL e immagine del profilo, biografia, link esterni e della biografia, flag di verifica e privacy, categoria, segnali business e professionali, conteggi visibili e collected_at.

Un account mancante, rinominato, non disponibile o inaccessibile può non produrre alcun record, mentre la disponibilità delle fonti pubbliche può lasciare vuoti singoli campi. Gli altri nomi utente validi nella stessa attività possono comunque restituire i record dei profili.

No. Cerca i record dei profili per nomi utente che conosci già; usa Instagram Search per la scoperta e gli endpoint Followers o Following per i membri delle relazioni.

Ogni risultato di profilo normalizzato restituito costa 0,6 crediti; un nome utente non risolto che non produce alcun risultato è coperto dalla policy configurata per i risultati vuoti.