Ottenere i post di un account Instagram tramite l'API
GET /<IG_ID>/media restituisce i post di un account professionale Instagram come oggetti IG Media, fino ai suoi 10.000 più recenti. Richiedi campi come id, media_type, media_url, permalink, thumbnail_url e timestamp, e leggi gli elementi di un carosello tramite children. Le risposte includono i cursori before e after per la paginazione, e since e until li limitano per data. Con Instagram Login la chiamata va a graph.instagram.com.
easyCoexistence elenca i post di un account Instagram collegato con list_social_posts, 1 a 100 alla volta, da Claude, ChatGPT o dal tuo codice, tramite l'API ufficiale di Meta con il token aggiunto.
Il massimo di media più recenti creati che il media edge restituisce, secondo il riferimento IG User Media di Meta.
I parametri di paginazione basati sul tempo del media edge, che accettano timestamp Unix o valori strtotime.
Dove si leggono le Storie: il media edge non restituisce i media di tipo Storia.
Il tipo di media che restituisce thumbnail_url, l'URL dell'immagine di anteprima del media.
Come Meta indica di trattare media_url, che manca per alcuni video; in alternativa usa permalink o thumbnail_url.
Come si ottengono i post di un account?
Con una GET sul media edge dell'account, indicando i campi da restituire; senza fields, l'esempio di Meta restituisce solo l'id di ogni post. Con Instagram Login la richiesta va a graph.instagram.com con un token di accesso Instagram User che include instagram_business_basic, e la risposta elenca i post in data, con un oggetto paging per la pagina successiva.
GET https://graph.instagram.com/<IG_ID>/media
?fields=id,media_type,media_url,permalink,thumbnail_url,timestamp
&limit=25
&access_token=<ACCESS_TOKEN>
{
"data": [
{
"id": "<IG_MEDIA_ID>",
"media_type": "IMAGE",
"media_url": "<CDN_URL>",
"permalink": "https://www.instagram.com/p/<SHORTCODE>/",
"timestamp": "2026-10-30T14:02:11+0000"
}
],
"paging": {
"cursors": { "before": "<CURSOR>", "after": "<CURSOR>" },
"next": "<NEXT_PAGE_URL>"
}
}Quali campi può restituire ogni post?
Quelli dell'oggetto IG Media, elencati nel riferimento di Meta; chiedi solo quelli che usi. Due righe di quel riferimento, caption e media_product_type, terminano con la nota Disponibile solo per Instagram API con Facebook Login, quindi verificali con la tua configurazione prima di affidarti a loro:
Come funziona la paginazione?
Con i cursori. L'oggetto paging contiene i cursori before e after e, finché restano risultati, un URL next; la guida Graph API di Meta dice di fermarsi quando next non compare più, perché una pagina può contenere meno elementi di quanti ne chiede limit. Il media edge pagina anche per tempo: since e until accettano timestamp Unix o valori strtotime e limitano i risultati a quell'intervallo.
Come si leggono le foto e i video di un carosello?
Tramite l'edge children. Un post il cui media_type è CAROUSEL_ALBUM elenca i suoi elementi con GET /<IG_MEDIA_ID>/children, usando lo stesso token e lo stesso permesso del media edge, e ogni elemento è un oggetto IG Media con il proprio id, media_type e media_url. Meta segnala che alcuni campi, tra cui permalink, non si possono usare sulle foto dentro un album.
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
?fields=id,media_type,media_url
&access_token=<ACCESS_TOKEN>Perché media_url manca su alcuni post?
Meta lo omette dai video che contengono audio protetto da copyright o con licenza, incluse le tracce della libreria audio di Instagram, e dai media segnalati per violazione del copyright, anche sui post dell'account stesso. Il suo riferimento dice di trattare media_url come facoltativo e di ripiegare su permalink o thumbnail_url. Un video Live si può leggere solo mentre è in trasmissione.
Come si mostrano i post su un sito web?
Dal tuo server, con il token a lunga durata dell'account, che dura 60 giorni e va rinnovato prima della scadenza. Collega ogni riquadro al suo permalink e aggiorna l'elenco a intervalli regolari: Meta serve i media tramite URL CDN attenti alla privacy che smettono di restituire un file una volta che il contenuto è stato eliminato o è scaduto. Per mostrare un post come lo disegna Instagram, passa il suo permalink all'endpoint oEmbed.
Come si elencano i post tramite easyCoexistence?
Con list_social_posts, che accetta account_id e un limit da 1 a 100, 25 per impostazione predefinita, e restituisce i post recenti dell'account con i relativi ID, tipi di media, URL dei media, anteprime, permalink, timestamp e conteggi di mi piace e commenti. Legge i post più recenti, fino a 100, e non ha un cursore per altre pagine o altri campi.
Errori comuni
- Cercare le Storie nel media edge. Meta le esclude; GET /<IG_ID>/stories le restituisce durante le 24 ore in cui restano visibili.
- Costruire un feed solo su media_url. Meta lo omette per alcuni video, quindi mantieni permalink o thumbnail_url come alternativa.
- Chiedere permalink sugli elementi del carosello. Meta non lo restituisce per le foto dentro un album, quindi collega il post padre.
- Considerare una pagina corta come l'ultima. Una pagina può contenere meno elementi di limit; fermati solo quando la paginazione non ha next.
Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni gratuiti.
Domande frequenti
Quanti post può restituire l'API di Instagram?
Fino ai 10.000 più recenti creati, una pagina alla volta dal media edge. Le Storie arrivano dall'edge separato stories finché restano visibili.
Il media edge include i Reel?
Sì. Un Reel è un oggetto IG Media come una foto, indicato con media_type VIDEO; le Storie sono ciò che il media edge esclude.
Posso ottenere i post di un altro account?
Non dal media edge, che legge l'account dietro il token. Business Discovery restituisce i post di un altro account di azienda o creator, con Facebook Login o Unified Login.
Perché un vecchio media_url ha smesso di funzionare?
Gli URL CDN di Meta sono attenti alla privacy: smettono di restituire i media una volta che il contenuto è eliminato o scaduto, quindi richiedi URL aggiornati quando ti servono.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il