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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Elenco 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.
- Prepara un array usernames non vuoto con gli account pubblici che già conosci.
- Invia con POST l’array usernames a /v1/instagram/profiles e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché status diventa succeeded o failed.
- 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 trueCasi 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.
API correlate
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.
- 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 Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API