Sua equipe precisa de metadados de postagens, reels e contas do Instagram em um formato que você possa enviar para produção esta semana—contagens, imagens, dimensões e informações do autor—sem engenharia reversa de HTML ou malabarismos com várias bibliotecas. Ao final deste guia, você será capaz de chamar a API de Dados do Instagram a partir do Zyla API Hub para buscar dados públicos de postagens por URL, dados de contas por nome de usuário e métricas de reels por shortcode, e integrá-los ao seu serviço ou agente de IA.
O que você pode construir com a API de Dados do Instagram
A API de Dados do Instagram no Zyla retorna informações estruturadas para recursos públicos do Instagram, para que você possa integrar conteúdo social ao seu produto sem scraping. Ela suporta:
- Dados de postagens/publicações por URL, incluindo dimensões de mídia, URLs de exibição e metadados relacionados.
- Dados de contas por nome de usuário, incluindo biografia e links da biografia.
- Dados de reels por shortcode, incluindo like_count, comment_count e video_view_count.
Casos de uso típicos incluem widgets de prova social, painéis de análise, moderação e enriquecimento de UGC, e pipelines de ingestão de conteúdo para relatórios de marketing.
O Zyla API Hub é um marketplace de conta única, com uma única chave de API, com um modelo de assinatura + cota (não pay-per-call) e um catálogo de mais de 10.000 APIs públicas nas categorias de Mídias Sociais & Networking e outras. Você pode navegar pelo marketplace em zylalabs.com e se inscrever em APIs individuais conforme necessário.
Começando no Zyla API Hub
Para integrar, abra a página da API de Dados do Instagram, clique em Inscrever-se ou Iniciar Teste Gratuito (quando disponível) e copie sua chave de API. Cada solicitação usa o cabeçalho de Autorização: Bearer YOUR_API_KEY.
Comece aqui: Iniciar teste de 7 dias na API de Dados do Instagram. A primeira API geralmente oferece um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.
Visão geral dos endpoints
1) Obter Dados de Postagem
Retorna dados de postagens/publicações do Instagram para uma URL de postagem pública.
- Método: GET
- URL: https://zylalabs.com/api/855/instagram-data-api/630/get-post-data
- Parâmetro de consulta obrigatório:
- link (string): URL da postagem do Instagram. Exemplo: https://www.instagram.com/p/BsOGulcndj-
Exemplo de cURL:
curl -s -X GET "https://zylalabs.com/api/855/instagram-data-api/630/get-post-data?link=https%3A%2F%2Fwww.instagram.com%2Fp%2FBsOGulcndj-" \
-H "Authorization: Bearer YOUR_API_KEY"Exemplo de resposta (exemplo oficial):
{
"status": true,
"__typename": "GraphImage",
"id": "1949525278281554174",
"shortcode": "BsOGulcndj-",
"dimensions": {
"height": 584,
"width": 584
},
"gating_info": null,
"fact_check_overall_rating": null,
"fact_check_information": null,
"sensitivity_friction_info": null,
"sharing_friction_info": {
"should_have_sharing_friction": false,
"bloks_app_url": null
},
"media_overlay_info": null,
"media_preview": null,
"display_url": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=instagram.fbcn2-1.fna.fbcdn.net&_nc_cat=105&_nc_oc=Q6cZ2gHBlHY2RHKNTgCNzMelAyz56Toi4DI7VUNsrK7XJAsoGT6ka4w7PVJ6IEqS7PD9Ulw&_nc_ohc=jwkKyc7eqGAQ7kNvwHmuCEW&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&edm=AOmX9WgBAAAA&ccb=7-5&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&oh=00_AQONRzWv-s9IPALJK9qeJ5FVyMcHbwpYaGsJhb7fdlV1nA&oe=6ACE9A40&_nc_sid=bfaa47",
"display_resources": [
{
"src": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e35_s360x360_sh2.08_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNTg0LnNkci5yZWd1bGFyX3Bob3RvLkMzIn0%3D&_nc_ohc=53XaOqCZWBYQ7kNvwFfkQTV&_nc_oc=AdprbrBLkElSfmNNOrQHEYQuCIz8F8lIlYN7TENXKNGCcZVnybmvx0uXH6fzElyfwak&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fbcn2-1.fna&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&_nc_ss=7a3ba&oh=00_AQNBRrpvxf3JGSktIaicSqaD4UtCuDo9I8feI6acpRs9Eg&oe=6ACE9A40",
"config_width": 360,
"config_height": 360
},
{
"src": "https://instagram.fbcn2-1.fna.fbcdn.net/v/t51.82787-15/625727639_18338153224242257_3827527793310630488_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ig_cache_key=MTk0OTUyNTI3ODI4MTU1NDE3NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNTg0LnNkci5yZWd1bGFyX3Bob3RvLkMzIn0%3D&_nc_ohc=53XaOqCZWBYQ7kNvwFfkQTV&_nc_oc=AdprbrBLkElSfmNNOrQHEYQuCIz8F8lIlYN7TENXKNGCcZVnybmvx0uXH6fzElyfwak&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fbcn2-1.fna&_nc_gid=BiA9YpCodvi1HtqMj6W-Vg&_nc_ss=7a3ba&oh=00_AQMhFQizLfIe4bAcskLHhT2nCDcjFGyldOq2Cp7IMLuVxg&oe=6ACE9A40",
"config_width": 584,
"config_height": 584
}
],
"accessibility_caption…Campos-chave que você normalmente usará:
- id e shortcode: identificadores estáveis para deduplicação e vinculação.
- dimensions: altura e largura da mídia.
- display_url e display_resources: URLs para ativos de mídia em diferentes tamanhos.
- __typename: dica do tipo de mídia (por exemplo, GraphImage).
2) Obter Dados da Conta
Retorna dados públicos da conta do Instagram pelo nome de usuário.
- Método: GET
- URL: https://zylalabs.com/api/855/instagram-data-api/631/get-account-data
- Parâmetro de consulta obrigatório:
- username (string): nome de usuário do Instagram. Exemplo: leomessi
Exemplo de cURL:
A resposta retorna metadados da conta, como a biografia e os links da biografia para o nome de usuário especificado.
3) Obter Dados do Reel
Retorna métricas públicas de reels/postagens do Instagram pelo shortcode. Inclui contagens de likes, comentários e visualizações.
- Método: GET
- URL: https://zylalabs.com/api/855/instagram-data-api/32007/get-reel-data
- Parâmetro de consulta obrigatório:
- shortcode (string): shortcode do Instagram para a postagem/reel. Exemplo: DctYV2qt6S5
Exemplo de cURL:
Exemplo de resposta (exemplo oficial):
Campos-chave que você normalmente usará:
- like_count e comment_count: métricas de engajamento para painéis e alertas.
- video_view_count (e play_count): rastreamento de desempenho do reel.
- code: eco do shortcode solicitado para correlação.
Exemplo de ponta a ponta em Python
O trecho abaixo busca métricas de reels pelo shortcode e imprime KPIs de engajamento. Ele usa o mesmo endpoint e parâmetros mostrados no exemplo de cURL acima.
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
SHORTCODE = "DctYV2qt6S5"
url = "https://zylalabs.com/api/855/instagram-data-api/32007/get-reel-data"
params = {"shortcode": SHORTCODE}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
data = resp.json()
# Extrair os campos que seu aplicativo provavelmente precisa
like_count = data.get("like_count")
comment_count = data.get("comment_count")
views = data.get("video_view_count")
print({
"shortcode": data.get("code"),
"likes": like_count,
"comments": comment_count,
"views": views
})JSON que você pode esperar (como mostrado acima):
Notas de implementação que economizam tempo
- Cabeçalho de Autorização: Sempre inclua Authorization: Bearer YOUR_API_KEY. Não envie a chave em parâmetros de consulta.
- Codificação de URL: Para Obter Dados de Postagem, o parâmetro link deve ser codificado em URL. O cURL fornecido mostra a forma correta.
- Dados públicos apenas: Esses endpoints retornam informações para recursos públicos do Instagram.
- Cache: Números de engajamento em reels podem mudar rapidamente. Se você estiver fazendo polling, armazene as respostas brevemente (por exemplo, 30–120 segundos) para evitar chamadas redundantes enquanto mantém os painéis atualizados.
- Tratamento de erros: Trate não-200s e erros de análise de JSON. O backoff exponencial ajuda se você agrupar atualizações.
- Quotas: As APIs do Zyla usam assinatura + cota. A primeira API geralmente inclui um teste de 7 dias ou 50 solicitações; verifique a listagem para limites atuais antes de executar grandes backfills.
Casos de uso do mundo real
- Incorporar postagens com metadados verificados: Resolva uma URL de postagem para dimensões e um display_url, armazene o shortcode e renderize com uma interface consistente.
- Páginas de criadores e marcas: Use Obter Dados da Conta para mostrar a biografia de uma conta e links de saída adjacentes a campanhas ou páginas de produtos.
- Rastreamento de desempenho de reels: Faça polling de Obter Dados do Reel para shortcodes de alta prioridade a cada minuto e envie deltas (likes, comentários, video_view_count) para seu armazenamento de métricas.
- QA automatizado em UGC: Valide se uma URL do Instagram submetida realmente resolve para uma imagem ou reel e atende aos seus requisitos de tamanho via dimensões.
Chamando a API de agentes de IA (MCP)
Você pode chamar as APIs do Zyla a partir de clientes compatíveis com MCP através do endpoint MCP em https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY. Isso é útil para prototipagem com ferramentas de codificação de IA ou para integrar verificações em runbooks executados por IA. Veja MCP para detalhes.
Coleção de solicitações prontas para copiar
Use essas solicitações exatas com sua chave inserida no cabeçalho de Autorização.
Obter Dados de Postagem (por URL)
Obter Dados da Conta (por nome de usuário)
Obter Dados do Reel (por shortcode)
Lista de verificação operacional
- Chaves no env: Armazene YOUR_API_KEY em seu gerenciador de segredos ou variável de ambiente.
- Monitoramento: Acompanhe não-200s e timeouts; tente novamente falhas transitórias.
- Modelo de dados: Persista o shortcode para postagens/reels para evitar duplicatas e permitir atualizações direcionadas.
- Taxa de mudança: Reels são atualizados com frequência; agende janelas de polling mais apertadas para itens prioritários e janelas mais longas para o restante.
- Gerenciamento de marketplace: Use seu painel do Zyla para monitorar o uso da cota. Você sempre pode explorar APIs adicionais de Mídias Sociais & Networking em zylalabs.com ao expandir recursos.
FAQ
Q: Como faço para autenticar solicitações?
A: Inclua o cabeçalho Authorization: Bearer YOUR_API_KEY em cada solicitação.
Q: Que entrada devo passar para Obter Dados de Postagem?
A: Forneça uma URL codificada em URL da postagem do Instagram através do parâmetro link, por exemplo link=https%3A%2F%2Fwww.instagram.com%2Fp%2FBsOGulcndj-.
Q: Que entrada devo passar para Obter Dados do Reel?
A: Forneça o valor do shortcode do reel/postagem alvo usando o parâmetro de consulta shortcode.
Q: A API retorna contagens de likes e visualizações?
A: Sim, Obter Dados do Reel retorna like_count, comment_count, play_count e video_view_count.
Q: Existe um plano gratuito?
A: O Zyla usa assinatura + cota. A primeira API geralmente inclui um teste de 7 dias ou 50 solicitações; verifique a listagem para opções de acesso e preços atuais.
Pronto para integrar isso ao seu pipeline? Crie sua conta e inicie o teste de 7 dias diretamente na listagem: Iniciar teste de 7 dias na API de Dados do Instagram. Sua única chave de API do Zyla funciona em qualquer outra API que você adicionar depois.
