Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Obter as publicações de uma conta do Instagram através da API

GET /<IG_ID>/media devolve as publicações de uma conta profissional do Instagram como objetos IG Media, até às suas 10 000 mais recentes. Peça campos como id, media_type, media_url, permalink, thumbnail_url e timestamp, e leia os itens de um carrossel através de children. As respostas trazem cursores before e after para a paginação, e since e until limitam-nas por data. Com o Instagram Login, o pedido vai para graph.instagram.com.

O easyCoexistence lista as publicações de uma conta do Instagram ligada com list_social_posts, de 1 a 100 de cada vez, a partir do Claude, do ChatGPT ou do seu próprio código, através da API oficial da Meta com o token acrescentado.

10,000

No máximo, a media edge devolve as publicações mais recentemente criadas, segundo a referência IG User Media da Meta.

since, until

Os parâmetros de paginação por tempo da media edge, que aceitam timestamps Unix ou valores strtotime.

/stories

Onde se leem as Stories: a media edge não devolve conteúdo Story.

VIDEO only

O tipo de multimédia que devolve thumbnail_url, o URL da miniatura da publicação.

Optional

Como a Meta indica tratar media_url, que omite em alguns vídeos; recorra ao permalink ou ao thumbnail_url.

Como se obtêm as publicações de uma conta?

Com um GET à media edge da conta, indicando os campos a devolver; sem fields, o exemplo da Meta devolve apenas o id de cada publicação. Com o Instagram Login, o pedido vai para graph.instagram.com com um token de acesso de utilizador do Instagram que tenha instagram_business_basic, e a resposta lista as publicações em data, com um objeto paging para a página seguinte.

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>"
  }
}

Que campos pode devolver cada publicação?

Os do objeto IG Media, listados na referência da Meta; peça apenas os que utiliza. Duas linhas dessa referência, caption e media_product_type, terminam com a nota Available for Instagram API with Facebook Login only, por isso verifique-as face à sua configuração antes de confiar nelas:

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

Como funciona a paginação?

Por cursores. O objeto paging traz os cursores before e after e, enquanto houver mais resultados, um URL next; o guia da Graph API da Meta indica parar quando next deixar de aparecer, pois uma página pode ter menos itens do que o limit pede. A media edge também pagina por tempo: since e until recebem timestamps Unix ou valores strtotime e mantêm os resultados nesse intervalo.

Como se leem as fotos e os vídeos de um carrossel?

Através da children edge. Uma publicação cujo media_type é CAROUSEL_ALBUM lista os seus itens com GET /<IG_MEDIA_ID>/children, usando o mesmo token e a mesma permissão da media edge, e cada item é um objeto IG Media com o seu próprio id, media_type e media_url. A Meta indica que alguns campos, entre eles o permalink, não podem ser usados nas fotos dentro de um álbum.

A carousel's items
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
  ?fields=id,media_type,media_url
  &access_token=<ACCESS_TOKEN>

Porque falta media_url em algumas publicações?

A Meta omite-o em vídeos que contêm áudio protegido por direitos de autor ou licenciado, incluindo faixas da biblioteca de áudio do Instagram, e em conteúdos marcados por violação de direitos de autor, nas publicações da própria conta também. A referência indica tratar media_url como opcional e recorrer ao permalink ou ao thumbnail_url. Um vídeo em direto só pode ser lido enquanto está a ser transmitido.

Como se mostram as publicações num site?

A partir do servidor, com o token de longa duração da conta, que dura 60 dias e tem de ser renovado antes de expirar. Associe cada miniatura ao seu permalink e atualize a lista de forma programada: a Meta serve os conteúdos através de URLs de CDN com proteção de privacidade, que deixam de devolver um ficheiro depois de o conteúdo ser eliminado ou expirar. Para mostrar uma publicação como o Instagram a apresenta, passe o seu permalink ao endpoint oEmbed.

Como se listam publicações através do easyCoexistence?

Com list_social_posts, que recebe o account_id e um limit de 1 a 100, por omissão 25, e devolve as publicações recentes da conta com os seus IDs, tipos de media, URLs de media, miniaturas, permalinks, timestamps e contagens de gostos e comentários. Lê as publicações mais recentes, até 100, e não tem cursor para mais páginas nem para outros campos.

Erros comuns

  • Procurar Stories na media edge. A Meta não as inclui; GET /<IG_ID>/stories devolve-as durante as 24 horas em que duram.
  • Criar um feed apenas com media_url. A Meta omite-o em alguns vídeos, por isso mantenha o permalink ou o thumbnail_url como alternativa.
  • Pedir permalink nos itens de um carrossel. A Meta não o devolve para as fotos dentro de um álbum; aponte o link para a publicação principal.
  • Tratar uma página curta como a última. Uma página pode ter menos itens do que o limit; pare apenas quando a paginação já não tiver next.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Quantas publicações pode devolver a API do Instagram?

Até às 10 000 mais recentes, uma página de cada vez a partir da media edge. As Stories vêm da stories edge separada enquanto duram.

A media edge inclui os Reels?

Sim. Um Reel é um objeto IG Media como uma foto, indicado com media_type VIDEO; as Stories são o que a media edge deixa de fora.

Posso obter as publicações de outra conta?

Não através da media edge, que lê a conta associada ao token. O Business Discovery devolve as publicações de outra conta empresarial ou de criador, com Facebook Login ou Unified Login.

Porque deixou de funcionar um media_url antigo?

Os URLs de CDN da Meta têm proteção de privacidade: deixam de devolver o conteúdo depois de este ser eliminado ou expirar, por isso peça URLs atuais sempre que precisar.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em