Você precisa de dados confiáveis de postagens e perfis do Instagram que possa integrar em um fluxo de trabalho de produção esta semana. Ao final deste artigo, você será capaz de buscar detalhes de postagens (dimensões, URLs de mídia, legendas, sinais de engajamento) e dados de perfil (nome de usuário, biografia, verificação, foto, links) usando a API de Dados do Instagram no Zyla API Hub, com requisições copiáveis e padrões prontos para integração.
O que você pode construir com a API de Dados do Instagram
A API de Dados do Instagram fornece dois endpoints de leitura de alto sinal que os desenvolvedores precisam rotineiramente para recursos de mídia social:
- Informações sobre Postagens: procure uma postagem pelo seu shortcode para recuperar metadados de mídia (flags de imagem/vídeo, dimensões, URLs), texto da legenda, resumo do perfil do proprietário e campos de engajamento.
- Detalhes do Perfil: procure um perfil pelo nome de usuário ou ID para recuperar status de verificação, foto do perfil, contexto de seguidores, biografia, links externos e outros descritores da conta.
Esses endpoints são úteis para painéis de análise social, monitoramento de marcas, auditoria de conteúdo automatizada, enriquecimento de links, verificações de verificação de perfil e pipelines de incorporação de postagens onde você precisa de atributos de mídia determinísticos antes de renderizar.
Começando no Zyla API Hub
Abra a lista de APIs no Zyla API Hub e inscreva-se para obter sua chave. O Hub funciona em um modelo de assinatura + cota (não por chamada). Para uma primeira API, você pode iniciar um teste de 7 dias ou 50 requisições. Verifique a página da API para opções de acesso e preços atuais.
- Iniciar teste de 7 dias na API de Dados do Instagram
- Navegue por mais de 10.000 APIs públicas no Zyla API Hub
A autenticação é enviada com cada requisição usando o cabeçalho HTTP Authorization: Bearer YOUR_API_KEY.
Endpoints que você usará
1) Informações sobre Postagens
Método: GET
URL: https://zylalabs.com/api/855/instagram-data-api/37566/post-information
Parâmetro de consulta obrigatório:
- code (string): O shortcode da postagem do Instagram. Exemplo: DfI02-LTwkc
O que ele retorna: informações detalhadas sobre a postagem do Instagram, incluindo shortcode, dimensões da mídia, URLs de imagem, flag de vídeo, legenda, detalhes do perfil do proprietário, data de publicação, curtidas e comentários.
Exemplo oficial de curl:
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37566/post-information?code=DfI02-LTwkc" \
-H "Authorization: Bearer YOUR_API_KEY"
Exemplo oficial de resposta JSON (verbatim):
{
"status": "ok",
"data": {
"post": {
"__typename": "GraphVideo",
"id": "4019695143460210972",
"shortcode": "DfI02-LTwkc",
"dimensions": {
"height": 718,
"width": 1020
},
"display_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7020f&oh=00_AQSFeFgTX4qgUU-VPIinjkrZASMg4NkxlFyIzab67V5zow&oe=6AEB0083",
"is_video": true,
"accessibility_caption": "Vídeo da Tesla em 30 de outubro de 2026. Pode ser uma imagem de limusine, minivan, noite e texto.",
"display_resources": [
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQR9wbRhfpvbBzM62jt9275twGnXRdiKlpV7kHlOv-NxBw&oe=6AEB0083",
"config_width": 720,
"config_height": 506
},
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQS1dgCJVbPnKwyP9gf442dDrUD3XTZzXdzz-VZ9sltSKA&oe=6AEB0083",
"config_width": 640,
"config_h…
Campos que você comumente lerá na resposta:
- post.shortcode: o shortcode único da postagem que você consultou.
- post.is_video: flag booleano que indica se você deve esperar um ativo de vídeo.
- post.dimensions.width/height: use para dimensionar contêineres ou gerar espaços reservados responsivos.
- post.display_url e post.display_resources[i].src: URLs de mídia que você pode armazenar ou cachear conforme necessário.
- post.accessibility_caption: útil para texto alternativo ou auditoria de conteúdo.
2) Detalhes do Perfil
Método: GET
URL: https://zylalabs.com/api/855/instagram-data-api/37572/profile-details
Parâmetro de consulta obrigatório:
- id_or_username (string): Nome de usuário do Instagram ou ID numérico. Exemplo: cristiano
O que ele retorna: informações detalhadas sobre o perfil do Instagram, incluindo nome de usuário, biografia, status de verificação, foto do perfil, contagens de seguidores e seguidos, links externos, destaques de histórias e detalhes da conta.
Exemplo oficial de curl:
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37572/profile-details?id_or_username=cristiano" \
-H "Authorization: Bearer YOUR_API_KEY"
Exemplo oficial de resposta JSON (verbatim):
{
"status": "ok",
"data": {
"user": {
"pk": "173560420",
"username": "cristiano",
"profile_pic_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.2885-19/472007201_1142000150877579_994350541752907763_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=YjSGq_4F5PwQ7kNvwGAf5GW&_nc_oc=AdrE9TNJ3DCmDwEYUzm5V1uTncNAl5vdTNunoBb6plzuRC7AMBnUZ4VPbRqG3H4p4dc&_nc_zt=24&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_ss=7060f&oh=00_AQQkDdv_NHNUxezd5SGePgHmJXPwMrXfPk1NrU-e_bz62w&oe=6AEB1EDE",
"is_private": false,
"is_unpublished": false,
"latest_reel_media": 0,
"biography": "",
"full_name": "Cristiano Ronaldo",
"is_verified": true,
"text_post_app_badge_label": null,
"show_text_post_app_badge": false,
"account_badges": [],
"bio_links": [
{
"image_url": "",
"is_pinned": false,
"link_id": "18122242507586533",
"link_type": "external",…
Campos que você comumente lerá na resposta:
- user.username e user.pk: chaves canônicas para seu armazenamento de usuários.
- user.is_verified e user.is_private: para verificações de verificação e fluxos de acesso.
- user.profile_pic_url: mostre um avatar ou armazene para cache CDN.
- user.full_name e user.biography: úteis para cartões de autor enriquecidos ao lado de postagens incorporadas.
- user.bio_links: extraia destinos fora da plataforma para análise de links ou atribuição de parceiros.
Exemplos de ponta a ponta que você pode colar
Python: Buscar Informações sobre Postagens e normalizar para renderização
Este exemplo em Python chama o endpoint de Informações sobre Postagens, extrai o dimensionamento da mídia, texto alternativo e uma URL de exibição preferida para seu front-end.
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
SHORTCODE = "DfI02-LTwkc"
url = "https://zylalabs.com/api/855/instagram-data-api/37566/post-information"
params = {"code": SHORTCODE}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
post = data.get("data", {}).get("post", {})
is_video = post.get("is_video")
dims = post.get("dimensions", {})
width, height = dims.get("width"), dims.get("height")
# Escolha um recurso de exibição: maior config_width se disponível, caso contrário, fallback para display_url
display_resources = post.get("display_resources", []) or []
best = None
if display_resources:
best = max(display_resources, key=lambda r: r.get("config_width", 0))
display_src = (best or {}).get("src") or post.get("display_url")
normalized = {
"shortcode": post.get("shortcode"),
"is_video": is_video,
"width": width,
"height": height,
"src": display_src,
"alt": post.get("accessibility_caption") or "",
}
print(normalized)
JavaScript (Node.js): Buscar Detalhes do Perfil pelo nome de usuário
Este trecho de Node.js solicita um perfil público pelo nome de usuário e extrai metadados de verificação e avatar para um componente de badge de autor.
import fetch from "node-fetch";
const API_KEY = process.env.ZYLA_API_KEY || "YOUR_API_KEY";
const username = "cristiano";
const url = "https://zylalabs.com/api/855/instagram-data-api/37572/profile-details?id_or_username=" + encodeURIComponent(username);
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
}
});
if (!res.ok) {
throw new Error(`Request failed: ${res.status} ${res.statusText}`);
}
const json = await res.json();
const user = (json.data && json.data.user) || {};
const author = {
username: user.username,
fullName: user.full_name,
verified: user.is_verified === true,
private: user.is_private === true,
avatar: user.profile_pic_url || null
};
console.log(author);
Notas práticas de implementação
- Entrada de shortcode: O endpoint de Informações sobre Postagens requer o shortcode da postagem (não uma URL completa). Armazene shortcodes como sua chave canônica para consultas de postagens.
- Escolhendo variantes de imagem: A resposta inclui display_resources com vários tamanhos. Escolha o maior config_width que você suporta para reduzir mudanças de layout.
- Texto alternativo: accessibility_caption é um forte padrão para texto alternativo. Recaia graciosamente se estiver ausente.
- Cache: URLs de mídia podem mudar; cache payloads normalizados (shortcode → imagem escolhida, largura/altura, alt) e implemente atualização em um cronograma adequado para sua UI.
- Tratamento de erros: Sempre verifique a presença de data.data.post ou data.data.user antes de desreferenciar campos.
- Quotas: Zyla usa assinatura + cota. Monitore seu uso de requisições e implemente caches locais simples para evitar consultas duplicadas em caminhos quentes.
Casos de uso comuns de mídias sociais que você pode implementar esta semana
1) Cartões de pré-visualização de postagens em editores de conteúdo
Permita que os editores colem uma URL de postagem do Instagram, analisem o shortcode e chamem Informações sobre Postagens para preencher automaticamente um cartão de pré-visualização com mídia, dimensões e trechos de legendas. Armazene o payload normalizado para renderização imediata e evite saltos de layout usando a largura/altura.
2) Badges de autor com verificação e avatar
Quando você renderiza uma postagem ou citação do Instagram, chame Detalhes do Perfil com o nome de usuário para mostrar um avatar preciso, o nome de exibição e um badge de verificação condicionalmente em user.is_verified.
3) Pipelines de monitoramento de marcas
Mantenha uma lista de nomes de usuários e atualize periodicamente os Detalhes do Perfil para rastrear mudanças de verificação, atualizações de nome de usuário ou mudanças de links de biografia. Alertas a jusante podem ser acionados em mudanças de bio_links ou alternâncias de is_private.
4) Análises de links enriquecidos
Quando um parceiro lista seu identificador do Instagram, use Detalhes do Perfil para confirmar que o identificador existe e puxe bio_links para descobrir seus destinos fora da plataforma antes de direcionar tráfego ou atribuir conversões.
5) Moderação de conteúdo e verificações de acessibilidade
Use accessibility_caption como um sinal para verificações automatizadas de texto alternativo. Marque postagens que faltam conteúdo semelhante a alt em fluxos de trabalho onde padrões de conformidade ou acessibilidade são exigidos.
Chamando a API de agentes de IA via MCP
Você pode conectar os mesmos endpoints em agentes de IA que suportam o Protocolo de Contexto do Modelo (MCP), incluindo Claude Code, Cursor e Windsurf. Configure seu agente para chamar o gateway MCP da Zyla:
- Endpoint: MCP
- Chave da API: passe YOUR_API_KEY conforme configurado pelo seu cliente compatível com MCP
Em tempo de execução, seu agente pode solicitar as mesmas URLs mostradas acima. Mantenha a autenticação consistente: Authorization: Bearer YOUR_API_KEY.
Dicas operacionais para produção
- Normalize cedo: Converta respostas em uma forma interna estável (por exemplo, Post {shortcode, isVideo, w, h, src, alt}). Armazene isso junto com timestamps para invalidação de cache.
- Política de repetição: Implemente breves e limitadas repetições em falhas de rede 5xx; registre respostas 4xx para visibilidade e evite loops.
- Renderização segura: Sempre proteja campos opcionais (por exemplo, display_resources pode estar ausente; recorra a display_url).
- Padrões de agrupamento: Ao enriquecer uma fila de nomes de usuários, espaçe chamadas e desduplicar dentro de uma janela de tempo para permanecer dentro da sua cota de assinatura.
Referência: Exemplos oficiais (conforme retornado pelo Hub)
Informações sobre Postagens: cURL
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37566/post-information?code=DfI02-LTwkc" \
-H "Authorization: Bearer YOUR_API_KEY"
Informações sobre Postagens: JSON
{
"status": "ok",
"data": {
"post": {
"__typename": "GraphVideo",
"id": "4019695143460210972",
"shortcode": "DfI02-LTwkc",
"dimensions": {
"height": 718,
"width": 1020
},
"display_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7020f&oh=00_AQSFeFgTX4qgUU-VPIinjkrZASMg4NkxlFyIzab67V5zow&oe=6AEB0083",
"is_video": true,
"accessibility_caption": "Vídeo da Tesla em 30 de outubro de 2026. Pode ser uma imagem de limusine, minivan, noite e texto.",
"display_resources": [
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQR9wbRhfpvbBzM62jt9275twGnXRdiKlpV7kHlOv-NxBw&oe=6AEB0083",
"config_width": 720,
"config_height": 506
},
{
"src": "https://scontent-fra5-1.cdninstagram.com/v/t51.82787-15/874355210_18644578207004135_6009842855742675310_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=100&ig_cache_key=NDAxOTY5NTE0MzQ2MDIxMDk3MjE4NjQ0NTc4MjA0MDA0MTM1.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjcyMC5zZHIudmlkZW9fdXNlcl9zZWxlY3RlZF90aHVtYm5haWwuQzMifQ%3D%3D&_nc_ohc=jiuH08gxR-UQ7kNvwEhFWEv&_nc_oc=AdpqckQyCQPV-2GIsLEePsnM3OkN0Qxd35INSdQRiEcG0k_ilHAVrX_UcfWw9cz9FMw&_nc_zt=23&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_gid=AurjIQpTzCx0zkhifUWrBg&_nc_ss=7060f&oh=00_AQS1dgCJVbPnKwyP9gf442dDrUD3XTZzXdzz-VZ9sltSKA&oe=6AEB0083",
"config_width": 640,
"config_h…
Detalhes do Perfil: cURL
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/37572/profile-details?id_or_username=cristiano" \
-H "Authorization: Bearer YOUR_API_KEY"
Detalhes do Perfil: JSON
{
"status": "ok",
"data": {
"user": {
"pk": "173560420",
"username": "cristiano",
"profile_pic_url": "https://scontent-fra5-1.cdninstagram.com/v/t51.2885-19/472007201_1142000150877579_994350541752907763_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=YjSGq_4F5PwQ7kNvwGAf5GW&_nc_oc=AdrE9TNJ3DCmDwEYUzm5V1uTncNAl5vdTNunoBb6plzuRC7AMBnUZ4VPbRqG3H4p4dc&_nc_zt=24&_nc_ht=scontent-fra5-1.cdninstagram.com&_nc_ss=7060f&oh=00_AQQkDdv_NHNUxezd5SGePgHmJXPwMrXfPk1NrU-e_bz62w&oe=6AEB1EDE",
"is_private": false,
"is_unpublished": false,
"latest_reel_media": 0,
"biography": "",
"full_name": "Cristiano Ronaldo",
"is_verified": true,
"text_post_app_badge_label": null,
"show_text_post_app_badge": false,
"account_badges": [],
"bio_links": [
{
"image_url": "",
"is_pinned": false,
"link_id": "18122242507586533",
"link_type": "external",…
Testes e monitoramento
- Testes de fumaça: Adicione uma etapa de CI que solicita um shortcode e nome de usuário conhecidos e afirma a presença de campos obrigatórios antes de implantar alterações na UI.
- Observabilidade: Registre falhas de decodificação com a URL de requisição original (sem segredos) para depurar rapidamente problemas de parâmetros.
- Backoff: Em respostas não-200 repetidas, faça um backoff e exiba um alerta no painel—não gire.
FAQ
P: Como faço para autenticar?
R: Inclua o cabeçalho Authorization: Bearer YOUR_API_KEY em cada requisição.
P: Onde consigo uma chave de API?
R: Abra a lista do marketplace e clique em Inscrever-se ou Iniciar Teste Gratuito, depois copie sua chave do painel.
P: Quais parâmetros são obrigatórios para cada endpoint?
R: Informações sobre Postagens requerem code (o shortcode da postagem). Detalhes do Perfil requerem id_or_username (um nome de usuário ou ID numérico).
P: Posso chamar esses endpoints de agentes de codificação de IA?
R: Sim. Use o gateway MCP da Zyla e configure seu agente para encaminhar as mesmas URLs e cabeçalho de Autorização. Veja o endpoint MCP.
P: Existe um plano gratuito?
R: Não há plano gratuito. O Hub usa assinatura + cota, e para uma primeira API você pode iniciar um teste de 7 dias ou 50 requisições. Verifique a lista para opções de acesso atuais.
Pronto para implementar sua integração com o Instagram? Crie uma conta, inscreva-se e comece a construir com a API de Dados do Instagram no Zyla API Hub.