API para informações de post

Você precisa de dados confiáveis de nível de post do Instagram e precisa disso esta semana. Ao final deste guia, você será capaz de buscar informações ricas de post do Instagram (shortcode, dimensões de mídia, bandeiras de imagem/vídeo, legendas e mais) a partir de um único HTTP GET no Zyla API Hub, analisar o JSON e integrá-lo ao seu pipeline ou produto.

O que você pode construir com um endpoint real de dados de post do Instagram

A API de Dados do Instagram no Zyla API Hub fornece acesso rápido e estruturado ao conteúdo do Instagram sem a necessidade de criar scrapers. Você fornece:

Ilustração: API para informações de post

Um link de post para obter dados de post/publicação.
Um nome de usuário para obter dados da conta.
Um shortcode para obter informações detalhadas do post, incluindo mídia, legenda, detalhes do perfil do proprietário, data de publicação, curtidas e metadados de comentários.

As equipes usam isso para enriquecer entradas de CMS, potencializar a expansão de links, automatizar relatórios e direcionar fluxos de trabalho de moderação. Como está no Zyla API Hub, você obtém uma conta, uma chave de API e um modelo de assinatura + cota em milhares de APIs—sem cobrança por chamada.

Começando no Zyla API Hub

Abra a listagem da API de Dados do Instagram no Zyla API Hub e inicie um teste para obter uma chave de API. A autenticação é via cabeçalho HTTP Authorization: Bearer YOUR_API_KEY. O marketplace funciona com assinatura + cota (não pagamento por chamada). Verifique a página da API para opções de acesso e preços atuais; você pode Iniciar teste de 7 dias na API de Dados do Instagram diretamente da página do item.

Endpoints que você usará

1) Obter Dados do Post

Forneça uma URL pública de post do Instagram para recuperar os dados de post/publicação.

Método: GET
URL: https://zylalabs.com/api/855/instagram-data-api/630/get-post-data
Parâmetro de consulta obrigatório:
- link (string): a URL do post do Instagram (codificada em URL). Exemplo: https://www.instagram.com/p/BsOGulcndj-

Copie e cole 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"

Resposta JSON oficial de exemplo:

{
"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…

O que você realmente usará aqui:

status: indica uma busca bem-sucedida.
shortcode: o código único que você pode usar em outros lugares.
dimensions: tamanho do ativo de mídia (pixels).
display_url: a URL direta da imagem para pré-visualizações ou cache.
display_resources: URLs de variantes de tamanho se você precisar de diferentes resoluções.

2) Obter Dados da Conta

Forneça um nome de usuário público do Instagram para recuperar os dados da conta.

Método: GET
URL: https://zylalabs.com/api/855/instagram-data-api/631/get-account-data
Parâmetro de consulta obrigatório:
- username (string): por exemplo, cristiano

Copie e cole cURL:

A resposta inclui metadados de perfil e links externos. Use-a para hidratar informações do autor para posts que você busca, ou para validar se um identificador existe antes de enfileirar a coleta de posts.

3) Informações do Post

Recupere dados detalhados do post do Instagram usando o shortcode.

Método: GET
URL: https://zylalabs.com/api/855/instagram-data-api/37566/post-information
Parâmetro de consulta obrigatório:
- code (string): por exemplo, DfI02-LTwkc

Copie e cole cURL:

Resposta de exemplo (abreviada para campos mostrados na listagem):

O que você realmente usará aqui:

__typename: informa se é uma imagem, vídeo, etc.
is_video: booleano para ramificar seu renderizador e comportamento do CDN.
display_url e display_resources: URLs para buscar ou armazenar mídia.
accessibility_caption: texto útil para texto alternativo ou resumos.
dimensions: guia para o manuseio da proporção de aspecto em sua interface.

Um exemplo funcional em Python

Este trecho de Python chama o endpoint de Informações do Post usando um shortcode e extrai os campos que você provavelmente mapeará em seus modelos.

import os
import requests

API_KEY = os.getenv("ZYLALABS_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()

if data.get("status") == "ok" and "data" in data and "post" in data["data"]:
post = data["data"]["post"]
out = {
"id": post.get("id"),
"shortcode": post.get("shortcode"),
"type": post.get("__typename"),
"is_video": post.get("is_video"),
"width": (post.get("dimensions") or {}).get("width"),
"height": (post.get("dimensions") or {}).get("height"),
"display_url": post.get("display_url"),
"accessibility_caption": post.get("accessibility_caption"),
}
print(out)
else:
print("Busca falhou ou nenhum payload de post:", data)

Notas:

O cabeçalho de autorização é obrigatório: Bearer YOUR_API_KEY.
Use timeouts em clientes HTTP. Armazene em cache as respostas do seu lado para evitar buscar posts estáticos novamente.
Shortcodes são strings opacas; não assuma formato além do que você recebe.

Detalhes de implementação prática que economizam tempo

Codificação de URL: Ao usar Obter Dados do Post, codifique o parâmetro de link. O cURL oficial mostra um valor de URL codificado.
Variantes de mídia: display_resources podem incluir vários tamanhos. Escolha o tamanho mais próximo da sua exibição alvo para reduzir a largura de banda.
Acessibilidade: accessibility_caption pode servir como texto alternativo e melhorar o suporte a leitores de tela.
Branch por tipo: Use __typename e is_video para decidir se deve renderizar um componente de imagem, player de vídeo ou lógica de carrossel em seu aplicativo.
Estabilidade: Metadados de nível de post são relativamente estáveis para posts públicos. Implemente um cache básico com uma expiração apropriada para seu produto (por exemplo, horas a dias) e atualize apenas se detectar mudanças que você se importa.
Quotas e acesso: APIs Zyla funcionam com assinatura + cota. Verifique a página de listagem para seus limites atuais. O primeiro passo é o teste de 7 dias na página do item.

De ponta a ponta: escolhendo o endpoint certo para seu fluxo

Se você começar com uma URL completa do Instagram: use Obter Dados do Post. Você receberá o shortcode e as URLs de mídia diretamente do link.
Se você começar apenas com um shortcode: chame Informações do Post. Você obterá detalhes de post mais ricos adequados para renderização e análises.
Se você precisar de contexto do autor: chame Obter Dados da Conta com o nome de usuário para puxar metadados de perfil e links para atribuição ou cartões de perfil.

Casos de uso do mundo real

Expansão de links em ferramentas de chat/suporte: Ao colar uma URL do Instagram, chame Obter Dados do Post, pegue display_url e dimensões, e renderize uma pré-visualização compacta com texto alternativo de accessibility_caption.
Pipelines editoriais: Quando editores adicionam um shortcode ao seu CMS, use Informações do Post para buscar mídia canônica, tipo e legendas; armazene largura/altura para layout responsivo.
Análises de criadores: Combine Informações do Post com suas métricas internas para relatar sobre a mistura de conteúdo (imagem vs. vídeo) e manter um arquivo de mídia com o tamanho adequado.
Moderação: Use Informações do Post para buscar rapidamente os metadados de mídia e legendas de um post e direcionar para revisão sem carregar a página da web completa.

Chamando a API de agentes de IA via MCP

Você pode invocar APIs no Zyla através de um cliente compatível com MCP (por exemplo, Claude Code, Cursor, Windsurf). Configure seu cliente com o endpoint MCP e sua chave; as chamadas são roteadas usando suas credenciais da API Zyla.

Endpoint MCP: MCP
Chave da API: use a mesma credencial Authorization: Bearer YOUR_API_KEY que você obteve na listagem da API de Dados do Instagram.

A partir daí, instrua seu agente a solicitar os endpoints da API de Dados do Instagram documentados acima, fornecendo os parâmetros de consulta necessários (link, nome de usuário ou código). Isso permite que você encadeie tarefas de recuperação e transformação dentro do agente com um código mínimo de ligação.

Lista de verificação operacional

Autenticação: Sempre envie Authorization: Bearer YOUR_API_KEY.
Codificação: codifique em URL o parâmetro de link para Obter Dados do Post.
Timeouts e tentativas: Use timeouts do cliente; implemente tentativas com backoff em problemas de rede transitórios.
Cache: Armazene em cache resultados de posts estáticos para reduzir latência e uso de cota.
Monitoramento: Registre o caminho do endpoint, valores de consulta (menos segredos), status e latência para detectar regressões precocemente.

Por que usar o Zyla API Hub

Uma conta e uma chave de API em mais de 10.000 APIs públicas em categorias como social, finanças, enriquecimento, IA, geolocalização e utilitários.
Modelo de assinatura + cota em vez de pagamento por chamada.
Endpoint MCP para fluxos de trabalho dirigidos por agentes.

Você pode começar diretamente da listagem da API de Dados do Instagram: Iniciar teste de 7 dias na API de Dados do Instagram.

FAQ

Que autenticação esta API usa?
Envie o cabeçalho HTTP Authorization: Bearer YOUR_API_KEY com cada solicitação.

Qual endpoint devo usar se eu tiver apenas a URL do Instagram?
Use GET https://zylalabs.com/api/855/instagram-data-api/630/get-post-data com o parâmetro de consulta link. Certifique-se de que a URL esteja codificada em URL.

Como obtenho detalhes de mídia mais ricos uma vez que tenho um shortcode?
Chame GET https://zylalabs.com/api/855/instagram-data-api/37566/post-information com code definido para o shortcode. Você receberá campos como __typename, is_video, dimensions, display_url, accessibility_caption e mais.

Posso buscar informações da conta para um nome de usuário?
Sim. Use GET https://zylalabs.com/api/855/instagram-data-api/631/get-account-data com username definido para o identificador.

Há um plano gratuito?
O acesso funciona com um modelo de assinatura + cota. Verifique a página da API para opções de acesso atuais; um teste de 7 dias começa a partir da página do item.

Pronto para implementar sua integração? Obtenha sua chave e comece a chamar os endpoints da listagem da API de Dados do Instagram: Iniciar teste de 7 dias na API de Dados do Instagram.