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.
No máximo, a media edge devolve as publicações mais recentemente criadas, segundo a referência IG User Media da Meta.
Os parâmetros de paginação por tempo da media edge, que aceitam timestamps Unix ou valores strtotime.
Onde se leem as Stories: a media edge não devolve conteúdo Story.
O tipo de multimédia que devolve thumbnail_url, o URL da miniatura da publicação.
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.
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:
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.
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.
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