Torna alle API
Dati pubblici di Instagram

Instagram Public Data API

Cerca o trova profili pubblici e raccogli con un unico flusso asincrono record degli elenchi di follower, relazioni di seguiti, post pubblicati, post in cui un profilo è taggato, risultati per hashtag, Reels, trascrizioni, commenti, numeri degli account, metriche di engagement e metadati dei media.

API di Instagram disponibili

Scegli un endpoint mirato per la ricerca di profili noti, la scoperta di profili, la raccolta degli elenchi di follower, la raccolta delle relazioni di seguiti, le metriche degli account, i post pubblicati, i post in cui un profilo è taggato, la ricerca per hashtag, i Reels, le trascrizioni o i commenti. Ogni endpoint usa lo stesso schema di autenticazione e di risultati delle attività di SocQ.

Quali dati di Instagram puoi recuperare?

SocQ normalizza i risultati pubblici di Instagram in record JSON stabili, così i team di prodotto non devono mantenere pipeline separate di automazione del browser e di pulizia delle risposte.

Profili e ricerca

Cerca nomi utente noti o account pubblici, con nomi utente, nomi visualizzati, biografie, URL dei profili, avatar, stato di verifica e segnali visibili dell’account.

Numeri di follower e degli account

Recupera il numero visibile di follower, seguiti e post per nomi utente o URL di profili pubblici.

Record degli elenchi pubblici di follower

Raccogli i profili dei follower visibili per nome utente di origine, con identità normalizzata, immagini del profilo, flag di visibilità, contesto della relazione, posizione osservata e orario di raccolta.

Relazioni pubbliche di seguiti

Raccogli i profili visibili pubblicamente seguiti da uno o più account di origine, con identità, visibilità, origine, relazione, posizione e contesto dei numeri dell’account, quando disponibili.

Post pubblicati e in cui un profilo è taggato

Raccogli i post pubblicati da nomi utente selezionati o i post che taggano profili selezionati, con didascalie, autori, media, contesto dei tag, timestamp ed engagement visibile.

Ricerca di post per hashtag

Trova i post pubblici per uno o più hashtag, con filtri facoltativi per intervallo di tempo e per Reels, oltre al contesto dell’hashtag corrispondente.

Reels pubblici

Raccogli didascalie dei Reel, riferimenti ai media, riproduzioni e conteggi di engagement, durata, hashtag, menzioni e metadati dell’audio, quando disponibili.

Trascrizioni di post e Reel

Estrai da URL pubblici di post o Reel il testo della trascrizione, la lingua, il formato e il contesto di origine; i media senza parlato possono non restituire alcun record.

Commenti pubblici

Raccogli da URL pubblici di post di Instagram testo dei commenti, campi dell’autore, timestamp, riferimenti ai post e numero visibile di Mi piace o di risposte.

SocQ vs Instagram Graph API

I due prodotti risolvono problemi di integrazione diversi. SocQ è pensato per la raccolta normalizzata di dati pubblici; l’API ufficiale di Meta è pensata soprattutto per gli account professionali autorizzati e per le azioni sulla piattaforma.

FunzionalitàSocQInstagram Graph API
Uso principaleRaccolta di dati pubblici su profili, elenchi di follower, relazioni di seguiti, contenuti e commentiGestire account Business e Creator autorizzati
OAuth del clienteChiave API di SocQ; nessun OAuth Instagram del clienteConfigurazione dell’app Meta e autorizzazione dell’account
PubblicazioneNon supportataSupportata per gli account professionali idonei
Contenuti privatiNon supportatiSolo i dati concessi tramite permessi autorizzati
Formato della rispostaNormalizzato su tutti gli endpoint di SocQStrutture di risposta native di Meta Graph

Come funzionano le API di Instagram

Tutti gli endpoint di Instagram seguono lo stesso flusso asincrono, che tiene la raccolta di lunga durata fuori dal thread della tua richiesta.

  1. 1. Invia un’attività

    Invia una richiesta POST con una query, nomi utente, hashtag o URL pubblici di profili e contenuti, più un limite di risultati facoltativo.

  2. 2. Interroga lo stato dell’attività

    Usa l’ID attività restituito finché l’attività ha successo o fallisce. Applica un rallentamento invece di cicli di nuovi tentativi serrati.

  3. 3. Leggi i risultati normalizzati

    Recupera gli elementi dei risultati, salva gli ID stabili e segui next_cursor quando sono disponibili altri record.

Inizia con una sola richiesta API

Autenticati con una chiave API di SocQ. Questo esempio avvia una ricerca di profili Instagram pubblici; la ricerca di profili noti, gli elenchi di follower, le relazioni di seguiti, i post pubblicati o taggati, la ricerca per hashtag, i Reels, le trascrizioni, i commenti e i numeri degli account usano lo stesso flusso di attività.

curl -X POST "https://api.socq.ai/v1/instagram/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sustainable travel","results_limit":25}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casi d’uso comuni delle API di Instagram

Ricerca di creator

Trova profili pubblici rilevanti, poi arricchisci gli account selezionati con post, Reels e metriche visibili dei follower.

Ricerca sugli elenchi di follower

Campiona i profili dei follower visibili pubblicamente, confronta le sovrapposizioni tra gli account di origine selezionati e metti in coda i nomi utente scelti per l’arricchimento dei profili.

Monitoraggio dei contenuti

Segui post pubblicati, post che taggano profili selezionati, risultati per hashtag, Reels, record di trascrizioni e commenti pubblici selezionati per campagne, concorrenti, creator o formati di contenuto ricorrenti.

Arricchimento delle analisi

Aggiungi identità social visibile e campi di engagement a dashboard interne, data warehouse e sistemi di reportistica.

Directory di ricerca

Crea dataset verificabili di account e contenuti pubblici con URL, ID e timestamp di raccolta stabili.

Limiti e policy sui dati pubblici

SocQ è limitato ai risultati di Instagram disponibili pubblicamente. La disponibilità può cambiare al variare di account, contenuti e risposte della fonte pubblica.

  • I contenuti privati, riservati, rimossi o accessibili solo con login non rientrano nell’ambito supportato.
  • I risultati degli elenchi di follower sono campioni pubblici e non esportazioni complete garantite, e lo stesso profilo può comparire sotto più account di origine inviati.
  • Alcuni record pubblici possono omettere contatori, campi dei commenti, riferimenti ai media, biografie o campi audio.
  • Usa frequenze di richiesta prudenti, la paginazione a cursore e un rallentamento dopo le risposte che segnalano pressione sul limite di frequenza.
  • Non usare l’API per pubblicare, modificare o eliminare contenuti di Instagram.

Domande frequenti sulle API di Instagram

È l’API ufficiale Instagram Graph API?

No. SocQ offre un accesso normalizzato ai risultati pubblici supportati di Instagram. Usa Meta Graph API quando ti serve la gestione autorizzata dell’account o la pubblicazione.

Gli utenti devono collegare il proprio account Instagram?

Per gli endpoint di dati pubblici supportati non serve alcun OAuth Instagram del cliente. Le richieste usano una chiave API di SocQ.

L’API può accedere ai profili privati?

No. I contenuti Instagram privati, riservati o accessibili solo con login non sono supportati.

Come viene calcolato il prezzo dell’utilizzo?

Ogni endpoint mostra il suo prezzo attuale in crediti per risultato. La fatturazione si basa sui record normalizzati restituiti dall’attività.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.