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.
Os posts mais recentemente criados que o media edge retorna, no máximo, segundo a referência IG User Media da Meta.
Os parâmetros de paginação por tempo do media edge, que aceitam timestamps Unix ou valores strtotime.
Onde os Stories são lidos: o media edge não retorna mídia de Stories.
O tipo de mídia que retorna thumbnail_url, a URL da imagem em miniatura da mídia.
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.
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:
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.
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.
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