Você precisa buscar programaticamente os detalhes completos de postagens do Instagram (título/legenda, autor, contagens, URLs de mídia) para uma URL que você já possui. Ao final deste guia, você irá recuperar esses campos de um único endpoint, analisá-los em código e saber onde ir para reels e histórias em destaque também—tudo usando uma chave de API no Zyla API Hub.
O que você irá construir com esta API
A API de Dados de Perfil e Mídia do Instagram retorna detalhes estruturados para conteúdo do Instagram que você já conhece pela URL ou ID. Você pode:
- Resolver uma URL de postagem para seu ID, legenda/título, informações do autor, contagens de curtidas/comentários e URLs de download de mídia.
- Procurar um reel pela URL e ler seu autor, engajamento e link de mídia para download.
- Expandir um destaque do Instagram (por ID de destaque) em suas histórias individuais com URLs de mídia.
Desenvolvedores usam isso para alimentar importações de CMS, pré-visualizações de backlinks, widgets de prova social, espelhamento de feeds e fluxos de arquivamento automatizados.
Começando no Zyla API Hub
Abra a lista de APIs no Zyla API Hub e comece um teste de 7 dias (ou use a opção de 50 solicitações quando disponível) para obter sua chave. A cobrança é por assinatura + cota, não por chamada, e não há plano gratuito. Sua chave de API autoriza solicitações via um cabeçalho de Autorização.
Comece o teste de 7 dias na API de Dados de Perfil e Mídia do Instagram
Com uma chave do Zyla API Hub, você pode chamar milhares de APIs em várias categorias. O mesmo modelo de assinatura e chave se aplica em todo o marketplace.
Endpoint que você veio buscar: Obter Detalhes da Postagem
Recupere informações detalhadas sobre uma postagem específica do Instagram usando sua URL (ou ID que você já possui).
- Método: GET
- URL da Solicitação: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- Parâmetro de consulta obrigatório: idOrUrl (string)
Exemplo: passe a URL da postagem.
curl -s -X GET "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details?username=a92_mm" \
-H "Authorization: Bearer YOUR_API_KEY"Resposta de exemplo oficial
{
"data": {
"id": "8640409651",
"username": "a92_mm",
"fullName": "",
"avatarUrl": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/117330532_764310710994941_3178952573818498232_n.jpg?_nc_cat=105&ig_cache_key=GGRS-gb9R230IrcCALjsQ_iF6B0sbkULAAAB0j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy42NTYuQzMifQ%3D%3D&_nc_ohc=UhqRB5XucjcQ7kNvwHzZrZa&_nc_oc=AdqQKMjA1CNJE2cZFGaOKLPAekcrEXjIih5fmtbyZIyBJ-ZZBqfAyZouTn139aCO8yM&_nc_zt=24&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_ss=7b62e&oh=00_AQSK1vbEqHI8iXnKTfwnP4mNcPHclgCyRAq7u5j4Lij_Pg&oe=6AE96358",
"biography": "",
"category": "",
"bioLinks": [],
"linkedFacebookInfo": null,
"followerCount": 5,
"followingCount": 34,
"isPrivateAccount": true,
"isVerified": false,
"totalPosts": 9
}
}Notas de campo para implementadores:
- data.id e data.code identificam a postagem; code mapeia para o caminho /p/{code}.
- data.title é a legenda/título da postagem. Armazene como UTF‑8.
- data.createdAt é um timestamp Unix (segundos). Converta conforme necessário em seu tratamento de fuso horário.
- data.author inclui nome de usuário canônico, status de verificação e URL do avatar.
- data.statistics.likeCount e commentCount fornecem métricas de engajamento.
- data.mediaList contém URLs de mídia para download que você pode buscar diretamente. Respeite as políticas de cache e expiração de links do host de destino; armazene o arquivo resolvido do seu lado se precisar de ativos estáveis.
Exemplo em Python: obter uma postagem pela URL e ler campos-chave
import os
import requests
from datetime import datetime, timezone
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
POST_URL = "https://www.instagram.com/p/DfALy1PTBSa/"
endpoint = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details"
params = {"idOrUrl": POST_URL}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(endpoint, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json().get("data", {})
post_id = data.get("id")
code = data.get("code")
title = data.get("title", "")
created_at = data.get("createdAt")
dt = datetime.fromtimestamp(created_at, tz=timezone.utc) if created_at else None
author = data.get("author", {})
username = author.get("username")
is_verified = author.get("isVerified")
stats = data.get("statistics", {})
likes = stats.get("likeCount")
comments = stats.get("commentCount")
media = data.get("mediaList", [])
first_download_url = media[0].get("downloadUrl") if media else None
print("Post:", post_id, code)
print("Author:", username, "(verificado)" if is_verified else "")
print("Caption:", title)
print("Created at (UTC):", dt)
print("Engagement: likes =", likes, ", comments =", comments)
print("First media URL:", first_download_url)Outros endpoints disponíveis que você pode precisar a seguir
Se sua integração se expandir além de postagens estáticas, a mesma API cobre reels e histórias em destaque.
Obter Detalhes do Reel
- Método: GET
- URL da Solicitação: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- Parâmetro de consulta obrigatório: idOrUrl (string), por exemplo, uma URL de reel
Isso retorna o id do reel, código, bloco do autor, createdAt, título, estatísticas (contagens de curtidas/comentários) e um downloadUrl. Trate createdAt como um epoch Unix (segundos) e armazene author.username para atribuição.
Obter Detalhes da História em Destaque
- Método: GET
- URL da Solicitação: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- Parâmetro de consulta obrigatório: id (string), que é o ID do destaque
Use isso quando você já souber um ID de destaque e precisar de todas as histórias incluídas. Você receberá o título do destaque, totalStories e um array de histórias com mediaType, createdAt, thumbnailUrl e downloadUrl por história.
Exemplo de listagem oficial do hub (detalhes do perfil)
A API também expõe uma pesquisa de perfil. Abaixo está o exemplo oficial da listagem do Zyla Hub para referência.
Armazene snapshots de followerCount/totalPosts se você planeja acompanhar métricas ao longo do tempo. isPrivateAccount pode limitar o que endpoints de mídia downstream podem retornar para esse usuário.
Notas práticas de implementação
- Autenticação: envie Authorization: Bearer YOUR_API_KEY em cada solicitação.
- Timestamps: campos createdAt são segundos de epoch Unix. Converta usando UTC, depois formate no fuso horário do usuário, se necessário.
- Downloads de mídia: downloadUrl e thumbnailUrl apontam para recursos CDN. Esses links podem expirar; se você precisar de longevidade, faça o download e armazene ativos em seu próprio armazenamento com validação de cache.
- Tratamento de erros: trate dados vazios ou campos ausentes como não fatais; conteúdo social pode ser excluído ou restrito.
- Volume de solicitações: o hub usa assinatura + cota (não por chamada). As primeiras opções de acesso são um teste de 7 dias ou 50 solicitações quando disponíveis. Verifique a página da API para opções de acesso e preços atuais.
Chame esses endpoints de agentes de IA via MCP
Se você automatizar via ferramentas de codificação de IA (Claude Code, Cursor, Windsurf ou qualquer cliente compatível com MCP), você pode direcionar solicitações através do endpoint MCP da Zyla:
- Endpoint para agentes: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
- Documentação de ferramentas: MCP
Expose uma ferramenta em seu agente que chama as URLs exatas do hub documentadas acima, passe o cabeçalho de Autorização e analise as mesmas estruturas JSON. Mantenha a lógica de negócios (por exemplo, escolhendo o primeiro item da mediaList) no código da ferramenta do seu agente para minimizar tokens do modelo.
Exemplos de ponta a ponta que você pode enviar esta semana
- Auto-incorpore uma postagem em um CMS: resolva idOrUrl para título, author.username, statistics.likeCount e mediaList[0].downloadUrl; armazene por 24 horas; revalide ao publicar.
- Snapshot de engajamento semanal: busque periodicamente postagens que você se importa e registre statistics.likeCount/commentCount e createdAt para gráficos de tendência.
- Reels feature rail: get-reel-details pela URL, exiba author.profilePictureUrl, título e um botão de reprodução vinculado a downloadUrl.
- Galeria de destaques: para um ID de destaque conhecido, liste stories[].thumbnailUrl em uma grade; ao clicar, transmita stories[].downloadUrl.
Referência: endpoints e parâmetros reais
- Obter Detalhes da Postagem (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- Parâmetro obrigatório: idOrUrl (string), por exemplo, https://www.instagram.com/p/DfALy1PTBSa/
- Obter Detalhes do Reel (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- Parâmetro obrigatório: idOrUrl (string), por exemplo, https://www.instagram.com/reel/DctYV2qt6S5/
- Obter Detalhes da História em Destaque (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- Parâmetro obrigatório: id (string), por exemplo, 17910014403011985
- Obter Detalhes do Perfil (GET, exemplo de listagem): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- Parâmetro obrigatório: username (string)
Explore mais categorias no Zyla API Hub; o marketplace lista mais de 10.000 APIs públicas sob uma única conta e chave.
FAQ
Como eu me autentico?
Envie um cabeçalho HTTP: Authorization: Bearer YOUR_API_KEY em cada solicitação.
Qual é o formato de createdAt?
Segundos de epoch Unix. Converta para um datetime em UTC, depois formate para seu fuso horário preferido.
Os URLs de mídia expiram?
Eles podem. Se você precisar de ativos estáveis, busque downloadUrl e armazene o conteúdo em seu próprio armazenamento, respeitando os termos de origem.
Há um plano gratuito?
Não há plano gratuito. Você pode começar com um teste de 7 dias ou 50 solicitações quando disponíveis; verifique a página da API para opções de acesso e preços atuais.
Posso chamar esses endpoints de um agente de IA?
Sim. Use o gateway MCP em https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY e faça o agente chamar as mesmas URLs do hub com o cabeçalho de Autorização.
Pronto para enviar? Pegue sua chave e comece a chamar os endpoints a partir da página de listagem: Comece o teste de 7 dias na API de Dados de Perfil e Mídia do Instagram.
