EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Obter os posts de uma conta do Instagram pela API

GET /<IG_ID>/media retorna os posts de uma conta profissional do Instagram como objetos IG Media, até os 10.000 criados mais recentemente. Peça campos como id, media_type, media_url, permalink, thumbnail_url e timestamp, e leia os itens de um carrossel pelo children. As respostas trazem cursores before e after para paginação, e since e until limitam por data. Com Instagram Login, a chamada vai para graph.instagram.com.

O easyCoexistence lista os posts de uma conta do Instagram conectada com list_social_posts, de 1 a 100 por vez, pelo Claude, pelo ChatGPT ou pelo seu próprio código, pela API oficial da Meta com o token incluído.

10,000

Os posts mais recentemente criados que o media edge retorna, no máximo, segundo a referência IG User Media da Meta.

since, until

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

/stories

Onde os Stories são lidos: o media edge não retorna mídia de Stories.

VIDEO only

O tipo de mídia que retorna thumbnail_url, a URL da imagem em miniatura da mídia.

Optional

Como a Meta orienta tratar media_url, que ela omite em alguns vídeos; use permalink ou thumbnail_url como alternativa.

Como obter os posts de uma conta?

Com um GET no media edge da conta, informando os campos a retornar; sem fields, o exemplo da Meta retorna apenas o id de cada post. Com Instagram Login, a requisição vai para graph.instagram.com com um token de acesso de Instagram User que tenha instagram_business_basic, e a resposta lista os posts em data, com um objeto paging para a próxima página.

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

Quais campos cada post pode retornar?

Os do objeto IG Media, listados na referência da Meta; peça apenas os que você usa. Duas linhas dessa referência, caption e media_product_type, terminam com a nota Available for Instagram API with Facebook Login only, então confira-as com a sua configuração antes de depender delas:

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, uma URL next; o guia da Graph API da Meta orienta parar quando next deixar de aparecer, pois uma página pode ter menos itens do que o limit pede. O media edge também pagina por tempo: since e until aceitam timestamps Unix ou valores strtotime e mantêm os resultados nesse intervalo.

Como ler as fotos e vídeos de um carrossel?

Pelo children edge. Um post cujo media_type é CAROUSEL_ALBUM lista seus itens com GET /<IG_MEDIA_ID>/children, usando o mesmo token e a mesma permissão do media edge, e cada item é um objeto IG Media com seu próprio id, media_type e media_url. A Meta observa que alguns campos, entre eles 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>

Por que media_url falta em alguns posts?

A Meta a omite de mídias de vídeo que contêm áudio protegido por direitos autorais ou licenciado, incluindo faixas da biblioteca de áudio do Instagram, e de mídias sinalizadas por violação de direitos autorais, inclusive nos posts da própria conta. A referência diz para tratar media_url como opcional e usar permalink ou thumbnail_url como alternativa. Um vídeo Live só pode ser lido enquanto está sendo transmitido.

Como mostrar os posts em um site?

No seu servidor, com o token de longa duração da conta, que vale 60 dias e precisa ser renovado antes de expirar. Vincule cada item ao seu permalink e atualize a lista em intervalos regulares: a Meta entrega mídia por URLs de CDN conscientes de privacidade, que deixam de retornar o arquivo quando o conteúdo é apagado ou expira. Para exibir um post como o Instagram o desenha, passe o permalink dele ao endpoint oEmbed.

Como listar posts pelo easyCoexistence?

Com list_social_posts, que recebe o account_id e um limit de 1 a 100, 25 por padrão, e retorna os posts recentes da conta com seus IDs, tipos de mídia, URLs de mídia, miniaturas, permalinks, timestamps e contagens de curtidas e comentários. Ela lê os posts mais recentes, até 100, e não tem cursor para outras páginas ou outros campos.

Erros comuns

  • Procurar Stories no media edge. A Meta os deixa de fora; GET /<IG_ID>/stories os retorna durante as 24 horas em que duram.
  • Montar um feed só com media_url. A Meta a omite em alguns vídeos, então mantenha permalink ou thumbnail_url como alternativa.
  • Pedir permalink nos itens de carrossel. A Meta não o retorna para fotos dentro de um álbum, então vincule ao post pai.
  • Tratar uma página curta como a última. Uma página pode ter menos itens que limit; pare somente quando a paginação não tiver next.
Fazendo isso com o EasyCoexistence

US$ 9 a US$ 0.75 por conexão por mês, com queda conforme você adiciona conexões, e os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Quantos posts a API do Instagram pode retornar?

Até os 10.000 criados mais recentemente, uma página por vez pelo media edge. Os Stories vêm do edge stories separado enquanto duram.

O media edge inclui Reels?

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

Posso obter os posts de outra conta?

Não pelo media edge, que lê a conta por trás do token. O Business Discovery retorna os posts de outra conta business ou de criador, com Facebook Login ou Unified Login.

Por que uma media_url antiga parou de funcionar?

As URLs de CDN da Meta são conscientes de privacidade: deixam de retornar a mídia quando o conteúdo é apagado ou expira, então solicite URLs atuais quando precisar delas.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

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

Verificado em