Você precisa obter detalhes confiáveis do perfil do Instagram rapidamente—nome de usuário, verificação, contagem de seguidores, status de privacidade—para que você possa enriquecer registros de usuários, alimentar um fluxo de inscrição ou validar criadores. Ao final deste guia, você obterá dados de perfil em uma solicitação e saberá como pegar detalhes de postagens, reels e destaques quando precisar—tudo através da mesma chave de API no Zyla API Hub.
O que esta API oferece
A API de Dados de Perfil e Mídia do Instagram retorna metadados de perfil (id, nome de usuário, URL do avatar, contagens de seguidores e seguidos, bandeiras de verificação e privacidade, total de postagens) e permite que você obtenha detalhes de mídia para postagens, reels e histórias em destaque. As equipes a utilizam para:
- Validar criadores e parceiros durante a integração.
- Enriquecer registros de CRM com contagens de seguidores e estado de verificação.
- Resolver uma URL de postagem ou reel para estatísticas e informações do autor para rastreamento de campanhas.
- Construir seletores de conteúdo e pipelines de download para histórias em destaque.
Tudo funciona através do Zyla API Hub com uma única assinatura e chave. Você também pode chamar esses endpoints a partir de agentes de codificação de IA usando o endpoint MCP.
Começando no Zyla API Hub
Abra a página da API, inscreva-se e pegue sua chave. A primeira API em uma nova conta 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. A autenticação é via o cabeçalho HTTP Authorization: Bearer YOUR_API_KEY. A cobrança é por assinatura + cota, não por chamada.
Comece o teste de 7 dias na API de Dados de Perfil e Mídia do Instagram
Endpoint: Obter Detalhes do Perfil
Use isso quando você precisar da identidade central e das estatísticas públicas de um usuário do Instagram. Ele retorna id, nome de usuário, URL do avatar, biografia, categoria, contagens de seguidores/seguidos, bandeiras de privacidade e verificação, total de postagens e mais onde disponível.
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- Parâmetro obrigatório: username (string)
- Auth: Authorization: Bearer YOUR_API_KEY
cURL que você pode colar
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"
Exemplo de 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 de campo que você realmente usará:
- id: Identificador de conta estável.
- username: Nome de usuário atual (pode mudar; armazene tanto o id quanto o nome de usuário).
- avatarUrl: Link direto do CDN para renderização.
- followerCount, followingCount: Inteiros para rastreamento de crescimento.
- isPrivateAccount: Se verdadeiro, postagens não são acessíveis sem permissão; planeje sua interface de usuário de acordo.
- isVerified: Verificação de badge para validação de criadores.
- totalPosts: Sinal de atividade em alto nível.
Exemplo em Python (requests)
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details"
params = {"username": "a92_mm"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
data = resp.json()["data"]
print("ID:", data["id"])
print("Username:", data["username"])
print("Verified:", data["isVerified"])
print("Private:", data["isPrivateAccount"])
print("Followers:", data["followerCount"])
print("Following:", data["followingCount"])
print("Total posts:", data["totalPosts"])
print("Avatar URL:", data["avatarUrl"])
Outros endpoints úteis para fluxos de trabalho orientados a perfil
Uma vez que você tenha o perfil de um usuário, você frequentemente precisará aprofundar em mídias específicas. Esses endpoints ajudam você a obter páginas de detalhes para postagens individuais, reels ou histórias em destaque. Todos usam o mesmo cabeçalho de Autorização e retornam campos específicos de mídia; os timestamps são em segundos Unix.
Obter Detalhes da Postagem
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- Parâmetro obrigatório: idOrUrl (string), por exemplo uma URL de postagem como https://www.instagram.com/p/DfALy1PTBSa/
O que faz: Recupera informações detalhadas sobre uma postagem específica usando id ou url. A resposta inclui campos como id, código, título, createdAt (segundos Unix), objeto autor (id, nome de usuário, nome completo, isVerified, profilePictureUrl), totalMedia, estatísticas (likeCount, commentCount) e itens mediaList incluindo downloadUrl onde disponível. Use isso para resolver um link de compartilhamento para metadados do autor e estatísticas de engajamento.
Obter Detalhes do Reel
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23421/get-reel-details
- Parâmetro obrigatório: idOrUrl (string), por exemplo uma URL de reel como https://www.instagram.com/reel/DctYV2qt6S5/
O que faz: Recupera informações detalhadas sobre um reel específico do Instagram usando id ou url. A resposta inclui campos como id, código, createdAt (segundos Unix), título, objeto autor, estatísticas (commentCount, likeCount) e um downloadUrl onde aplicável. Ótimo para relatórios de campanha quando você só tem um link de reel de um criador.
Obter Detalhes da História em Destaque
- Método: GET
- URL: https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23422/get-highlight-story-details
- Parâmetro obrigatório: id (string), um ID de destaque como 17910014403011985
O que faz: Recupera todas as histórias dentro de um destaque específico do Instagram usando o ID do destaque. A resposta inclui o id do destaque, título, totalStories e um array de histórias com campos como id, mediaType, createdAt (segundos Unix), thumbnailUrl e downloadUrl onde disponível. Use isso para renderizar visualizadores de destaque ou fazer backup de um conjunto de destaques.
Notas práticas de integração que economizam tempo
- Autenticação: Sempre envie Authorization: Bearer YOUR_API_KEY.
- Timestamps: campos createdAt são segundos Unix. Converta com as utilidades padrão da sua linguagem.
- Contas privadas: Se isPrivateAccount for verdadeiro, espere mídias ausentes ou inacessíveis em outros lugares; trate de forma elegante.
- Cache: Contagens de perfil podem ser armazenadas em cache por minutos para reduzir chamadas duplicadas; ajuste às necessidades de frescor da sua interface de usuário.
- IDs vs URLs: Para postagens e reels, idOrUrl permite que você passe links de compartilhamento diretamente—sem etapa extra de análise em seu aplicativo.
- Downloads: Campos downloadUrl de mídia apontam para links do CDN. Estes podem expirar; busque sob demanda ou atualize URLs antes do uso.
- Quotas: O acesso é por assinatura + cota. A primeira API em sua conta geralmente vem com um teste de 7 dias ou 50 solicitações; confirme na página de listagem antes de testar carga.
Fluxos do mundo real
1) Integração e verificação de criadores
Quando um criador insere seu nome de usuário do Instagram, chame Obter Detalhes do Perfil para buscar isVerified, followerCount e isPrivateAccount. Rejeite contas privadas ou de baixo sinal automaticamente ou direcione para revisão manual. Armazene o id junto ao nome de usuário para permanecer resiliente a mudanças de handle.
2) Capturas de desempenho de campanha
Influenciadores compartilham links para postagens ou reels. Passe esse link para Obter Detalhes da Postagem ou Obter Detalhes do Reel via idOrUrl, então registre statistics.likeCount e statistics.commentCount junto com author.username. Refaça a consulta periodicamente para manter um histórico de desempenho.
3) Seletores de conteúdo e downloads de ativos
Para portfólios, puxe conjuntos de destaques via Obter Detalhes da História em Destaque. Exiba histórias com thumbnailUrl e permita que os usuários baixem ativos usando downloadUrl se presente. Lembre-se de que links do CDN podem expirar; busque na hora ou atualize links antes de renderizar um botão de download.
Chamando a API a partir de agentes de IA via MCP
Se você usa Claude Code, Cursor, Windsurf ou qualquer cliente compatível com MCP, pode permitir que o agente chame as APIs do Zyla com sua chave existente através do endpoint MCP. Forneça sua chave de API e faça o agente emitir as mesmas solicitações GET mostradas acima; o cabeçalho de Autorização permanece o mesmo. Isso é útil para automatizar buscas de dados ou estruturar código de integração a partir de prompts em linguagem natural.
Referência: URLs e parâmetros de solicitação exatos
- Obter Detalhes do Perfil (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23416/get-profile-details
- username (string, obrigatório)
- Obter Detalhes da Postagem (GET): https://zylalabs.com/api/12390/instagram-profile-and-media-data-api/23420/get-post-details
- idOrUrl (string, obrigatório), ex: 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
- idOrUrl (string, obrigatório), ex: 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
- id (string, obrigatório), ex: 17910014403011985
Exemplos oficiais adicionais que você pode consultar
Exemplo de Obter Detalhes da Postagem (nenhuma alteração necessária nos cabeçalhos)
Solicitação:
Resposta (excerto):
Exemplo de Obter Detalhes do Reel (nenhuma alteração necessária nos cabeçalhos)
Solicitação:
Resposta (excerto):
Exemplo de Obter Detalhes da História em Destaque (nenhuma alteração necessária nos cabeçalhos)
Solicitação:
Resposta (excerto):
Dicas de solução de problemas
- Erros 401 ou 403: Confirme o cabeçalho de Autorização e que a assinatura está ativa em sua conta.
- Campos vazios: Alguns perfis têm biografia/categoria em branco ou campos limitados quando privados; trate nulos e strings vazias.
- URLs de mídia expiradas: Se um downloadUrl falhar, busque novamente os detalhes da mídia para obter um link novo.
- URLs malformadas: Ao usar idOrUrl, passe a URL canônica completa do Instagram; codifique a URL ao construir strings de consulta.
FAQ
-
Como faço para autenticar solicitações?
Envie Authorization: Bearer YOUR_API_KEY no cabeçalho para cada solicitação.
-
Posso buscar um perfil por ID em vez de nome de usuário?
O endpoint de perfil aceita nome de usuário. Armazene o id retornado para chaves internas, mas consulte pelo nome de usuário como mostrado.
-
E se eu só tiver um link de compartilhamento para uma postagem ou reel?
Use idOrUrl com o link exato do Instagram em Obter Detalhes da Postagem ou Obter Detalhes do Reel. A API resolve e retorna autor, estatísticas e campos de mídia.
-
Os timestamps vêm em um formato padrão?
Sim. Campos createdAt são timestamps Unix em segundos. Converta para seu fuso horário local em seu aplicativo.
-
Há um plano gratuito?
O acesso é por assinatura + cota. A primeira API em sua conta 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.
Pronto para enviar sua integração? Inscreva-se e obtenha sua chave na página da API de Dados de Perfil e Mídia do Instagram. Seu teste de 7 dias começa lá, e você pode chamar endpoints de perfil, postagem, reel e destaque com a mesma chave: Comece o teste de 7 dias na API de Dados de Perfil e Mídia do Instagram