AccediInizia la prova gratuita
easyCoexistence API ufficiali

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.

10,000

Il massimo di media più recenti creati che il media edge restituisce, secondo il riferimento IG User Media di Meta.

since, until

I parametri di paginazione basati sul tempo del media edge, che accettano timestamp Unix o valori strtotime.

/stories

Dove si leggono le Storie: il media edge non restituisce i media di tipo Storia.

VIDEO only

Il tipo di media che restituisce thumbnail_url, l'URL dell'immagine di anteprima del media.

Optional

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.

Listing posts with their main fields
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:

idThe media's ID
media_typeCAROUSEL_ALBUM, IMAGE or VIDEO
media_urlThe image or video file; left out for some videos
thumbnail_urlA thumbnail image, on VIDEO media only
permalinkThe post's permanent URL; not on carousel items
timestampCreation date, ISO 8601 in UTC
shortcodeThe post's shortcode
usernameThe account that created the post
comments_count, like_countCounts; like_count is left out when the owner hides likes
alt_textDescriptive text for an image
is_comment_enabledWhether comments are turned on
caption, media_product_typeMarked Facebook Login only in Meta's reference

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.

A carousel's items
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.
Farlo con EasyCoexistence

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