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.

instagram/posts
Post0,34 crediti per risultato

instagram/post-info
Post0,5 crediti per risultato

instagram/hashtag-posts
Ricerca0,5 crediti per risultato

instagram/reels-search
Ricerca0,5 crediti per risultato

instagram/story-highlights
Post0,5 crediti per risultato

instagram/tagged-posts
Post0,5 crediti per risultato

instagram/transcript
Post0,7 crediti per risultato

instagram/audio-reels
Post0,5 crediti per risultato

instagram/comments
Commenti0,3 crediti per risultato

instagram/followers-count
Profili0,52 crediti per risultato

instagram/profiles
Profili0,6 crediti per risultato

instagram/followers-list
Profili0,3 crediti per risultato

instagram/following-list
Profili0,3 crediti per risultato

instagram/reels
Post0,52 crediti per risultato

instagram/search
Ricerca0,54 crediti per risultato

instagram/highlight-items
Post0,5 crediti per risultato

instagram/trending-reels
Post0,5 crediti per risultato

instagram/stories
Post0,5 crediti per risultato

instagram/similar-users
Profili0,5 crediti per risultato

instagram/comment-replies
Commenti0,3 crediti per risultato

instagram/post-likers
Profili0,3 crediti per risultato

instagram/location-info
Ricerca0,5 crediti per richiesta

instagram/location-posts
Post0,5 crediti per risultato

instagram/location-search
Ricerca0,5 crediti per richiesta

instagram/search-hashtags
Ricerca0,5 crediti per risultato

instagram/user-about
Profili0,5 crediti per richiesta
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à | SocQ | Instagram Graph API |
|---|---|---|
| Uso principale | Raccolta di dati pubblici su profili, elenchi di follower, relazioni di seguiti, contenuti e commenti | Gestire account Business e Creator autorizzati |
| OAuth del cliente | Chiave API di SocQ; nessun OAuth Instagram del cliente | Configurazione dell’app Meta e autorizzazione dell’account |
| Pubblicazione | Non supportata | Supportata per gli account professionali idonei |
| Contenuti privati | Non supportati | Solo i dati concessi tramite permessi autorizzati |
| Formato della risposta | Normalizzato su tutti gli endpoint di SocQ | Strutture 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. 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. 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. Leggi i risultati normalizzati
Recupera gli elementi dei risultati, salva gli ID stabili e segui next_cursor quando sono disponibili altri record.
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=50Casi 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à.
Combina i dati di più piattaforme per analisi di business più complete
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.
TikTok API
Raccogli profili TikTok pubblici supportati, metadati di video diretti, commenti di primo livello, risultati di ricerca dei video e video di hashtag specifici con un unico flusso di lavoro asincrono normalizzato.
YouTube API
Raccogli profili dei canali YouTube pubblici supportati, dettagli dei video, video dei canali, commenti, Shorts, risultati per parola chiave e hashtag e trascrizioni disponibili con un unico flusso di lavoro asincrono normalizzato.
Facebook API
Raccogli profili di pagine Facebook pubbliche, post, post di gruppi, commenti, eventi trovati per parola chiave e trascrizioni disponibili dei video, con campi normalizzati di identità, contenuti, origine, formato, luogo, media, reazioni, partecipazione ed engagement.
X API
Raccogli profili pubblici, relazioni di follower e seguiti, post, risposte, citazioni, repost, risultati di ricerca e tendenze attuali. Usa risultati coerenti per ricerca e monitoraggio.
LinkedIn API
Recupera dati pubblici di profili, aziende, post e offerte di lavoro su LinkedIn a partire da URL noti, con campi normalizzati su identità, carriera, azienda, contenuti, engagement e offerte.
Reddit API
Recupera post e commenti pubblici di Reddit a partire da URL noti, sfoglia i post new, top o hot dei subreddit oppure cerca discussioni per parola chiave e periodo di pubblicazione.