Você precisa de uma API para puxar detalhes do perfil do Instagram que você pode enviar esta semana. Ao final deste guia, você obterá o perfil de um usuário (id, nome de usuário, contagens, verificação, privacidade) e saberá como ler reels, postagens e histórias em destaque usando endpoints prontos para produção no Zyla API Hub.
O que você obtém desta API
A API de Dados de Perfil e Mídia do Instagram expõe endpoints somente leitura para recuperar:
- Detalhes do perfil pelo nome de usuário: id, avatar, biografia, contagens de seguidores/seguindo, bandeiras de verificação e privacidade, e total de postagens.
- Detalhes da postagem por URL ou id: título, autor, contagens, lista de mídia e links para download.
- Detalhes do reel por URL ou id: autor, contagens, título, hora de criação e uma URL de download.
- Detalhes da história em destaque pelo id da história em destaque: título, total de histórias e tipo de mídia de cada história, timestamps, miniaturas e links para download.
Esses endpoints alimentam perfis voltados para o usuário, dashboards de CRM e enriquecimento, ferramentas de moderação/revisão de conteúdo e fluxos de trabalho de ingestão de mídia onde você deve resolver um recurso público do Instagram em campos estruturados que você pode armazenar em cache e indexar.
Começando no Zyla API Hub
Abra a página do marketplace para a API, inscreva-se e obtenha sua chave. A primeira API 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. A autenticação é via cabeçalho HTTP: Authorization: Bearer YOUR_API_KEY.
- Comece o teste de 7 dias na API de Dados de Perfil e Mídia do Instagram
- Navegue por mais de 10.000 APIs públicas no Zyla API Hub
Endpoint: Obter Detalhes do Perfil
Recupere dados do perfil para um nome de usuário do Instagram específico.
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- Parâmetros de consulta obrigatórios:
- username (string) — o nome de usuário do Instagram a ser resolvido
exemplo de cURL
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 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:
- As contagens são inteiros que você pode exibir diretamente.
- isPrivateAccount controla se você deve tentar buscar mídia para pré-visualizações de UI.
- avatarUrl é uma URL CDN adequada para renderização direta; considere armazenar em cache.
exemplo em Python
Este exemplo chama o mesmo endpoint e extrai os campos que você normalmente armazenará.
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
USERNAME = "a92_mm"
url = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details"
params = {"username": USERNAME}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json().get("data", {})
profile = {
"id": data.get("id"),
"username": data.get("username"),
"full_name": data.get("fullName"),
"avatar_url": data.get("avatarUrl"),
"bio": data.get("biography"),
"followers": data.get("followerCount"),
"following": data.get("followingCount"),
"is_private": data.get("isPrivateAccount"),
"is_verified": data.get("isVerified"),
"total_posts": data.get("totalPosts"),
}
print(profile)Endpoint: Obter Detalhes da Postagem
Recupere informações detalhadas sobre uma postagem específica usando um id ou uma URL canônica do Instagram.
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- Parâmetros de consulta obrigatórios:
- idOrUrl (string) — e.g. https://www.instagram.com/p/DfALy1PTBSa/
exemplo de cURL
A resposta retorna campos como id, código, título, createdAt (segundos da época Unix), autor (id, nome de usuário, nome completo, verificado, URL da imagem do perfil), totalMedia, estatísticas (likeCount, commentCount) e mediaList com entradas de downloadUrl.
Endpoint: Obter Detalhes do Reel
Recupere informações detalhadas sobre um reel específico do Instagram por id ou URL.
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- Parâmetros de consulta obrigatórios:
- idOrUrl (string) — e.g. https://www.instagram.com/reel/DctYV2qt6S5/
exemplo de cURL
A resposta inclui campos de nível superior como id, código, createdAt (segundos da época Unix), título, estatísticas (commentCount, likeCount), autor (id, nome de usuário, nome completo, verificado, URL da imagem do perfil) e um downloadUrl.
Endpoint: Obter Detalhes da História em Destaque
Recupere todas as histórias dentro de um destaque específico do Instagram usando o id do destaque.
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- Parâmetros de consulta obrigatórios:
- id (string) — o id do destaque, e.g. 17910014403011985
exemplo de cURL
A resposta retorna campos de nível de destaque como id, título, totalStories e um array de histórias com o id de cada história, mediaType (IMAGE ou VIDEO), createdAt (segundos da época Unix), thumbnailUrl e downloadUrl.
Notas de implementação prática
- Timestamps: os valores de createdAt são segundos da época Unix. Converta para o fuso horário do seu aplicativo na exibição.
- Cache: os campos de perfil e avatares de autor mudam com pouca frequência; armazene em cache por minutos a horas. URLs de mídia são links CDN e podem expirar; atualize conforme necessário.
- Privacidade: se isPrivateAccount for verdadeiro, não assuma que você pode acessar mídia através de outros endpoints. Proteja sua UI e trabalhos em segundo plano de acordo.
- Manipulação de mídia: os campos downloadUrl são links diretos. Transmita para armazenamento em vez de proxy através da sua API para reduzir a saída.
- Tratamento de erros: trate não-2xx como transitórios, a menos que você valide o nome de usuário/URL antes. Registre o nome de usuário solicitado ou idOrUrl e o status HTTP.
- Quotas: a cobrança é por assinatura + quota, não por chamada. Acompanhe suas contagens de chamadas e use cache para permanecer dentro dos limites do plano.
Exemplos de fluxo de trabalho de ponta a ponta
Enriquecimento de perfil para um formulário de inscrição
- O usuário insere um nome de usuário do Instagram em seu produto.
- Chame Obter Detalhes do Perfil com o nome de usuário e armazene id, followerCount, isPrivateAccount, isVerified e avatarUrl.
- Renderize o avatar e o badge de verificação em sua UI. Desative as pré-visualizações de mídia quando isPrivateAccount for verdadeiro.
Pipeline de ingestão editorial
- O editor cola uma URL de postagem em seu CMS.
- Chame Obter Detalhes da Postagem com idOrUrl e extraia título, author.username, statistics.likeCount e mediaList[0].downloadUrl.
- Coloque um downloader para buscar a mídia via downloadUrl e armazená-la em seu CDN. Armazene em cache os metadados da postagem para carregamento rápido da página.
Instantâneo de análises de reels
- O trabalho noturno itera uma lista de URLs de reels.
- Chame Obter Detalhes do Reel para cada um e salve statistics.commentCount e statistics.likeCount com um timestamp para gráficos de tendência.
Galeria de destaques
- Dado um id de destaque conhecido, chame Obter Detalhes da História em Destaque.
- Liste as histórias em ordem cronológica por createdAt. Use thumbnailUrl para pré-visualização em grade e proteja solicitações em tamanho real atrás de um clique.
Chame a API de agentes de IA via MCP
Todo Zyla API é acessível a partir de ferramentas de desenvolvedor compatíveis com MCP (Claude Code, Cursor, Windsurf, etc.) usando o endpoint MCP em: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY. Isso permite que você conecte um agente para chamar os mesmos endpoints do Instagram que você viu acima sem precisar implementar código de rede personalizado dentro do agente.
Saiba mais e conecte sua chave ao endpoint MCP aqui: MCP.
Por que enviar isso com Zyla
- Uma conta, uma chave, uma assinatura para cada API que você adicionar ao seu stack.
- Autenticação Bearer consistente e endpoints hospedados no hub, para que você não tenha que lidar com SDKs de cada fornecedor.
- Adicione mais capacidades a qualquer momento navegando no Zyla API Hub e se inscrevendo com a mesma identidade de cobrança.
Folha de dicas de mapeamento de campos
- Perfis: id, username, fullName, avatarUrl, biography, followerCount, followingCount, isPrivateAccount, isVerified, totalPosts.
- Postagens: id, code, title, createdAt, author{ id, username, fullName, isVerified, profilePictureUrl }, totalMedia, statistics{ likeCount, commentCount }, mediaList[ ].
- Reels: id, code, createdAt, title, statistics{ commentCount, likeCount }, author{ ... }, downloadUrl.
- Histórias em destaque: id, title, totalStories, stories[ { id, mediaType, createdAt, thumbnailUrl, downloadUrl } ].
Lista de verificação de envio
- Armazene o id do perfil ao lado do nome de usuário para chaves estrangeiras estáveis.
- Normalize timestamps para UTC e formate no cliente.
- Faça backoff e tente novamente em erros HTTP transitórios; interrompa em 4xx com validação.
- Armazene em cache detalhes do perfil e imagens de autor; defina um TTL que se encaixe na sua quota.
- Proteja buscas de mídia com isPrivateAccount e trate arrays de mídia vazios com segurança.
FAQ
Que autenticação esta API usa?
Use o cabeçalho Authorization: Bearer YOUR_API_KEY em cada solicitação.
Posso consultar por nome de usuário para perfis e por URL para mídia?
Sim. Obter Detalhes do Perfil usa nome de usuário. Obter Detalhes da Postagem e Obter Detalhes do Reel aceitam idOrUrl, então você pode passar uma URL canônica do Instagram.
Em que fuso horário estão as datas?
Os campos createdAt são segundos da época Unix (UTC). Converta do lado do cliente para o fuso horário do seu usuário.
Como a cobrança é tratada?
A Zyla usa assinatura + quota, não pagamento por chamada. A primeira API 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.
Posso invocar esses endpoints de um agente de codificação de IA?
Sim. Use o endpoint MCP em https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY. Veja: MCP.
Pronto para implementar buscas de perfil e buscas de mídia? Crie sua conta, obtenha uma chave de API e comece seu teste de 7 dias na página de listagem: Comece o teste de 7 dias na API de Dados de Perfil e Mídia do Instagram.
