Você precisa buscar programaticamente as URLs das Histórias ou Reels do Instagram para processamento posterior—renderizando prévias, moderando conteúdo ou salvando ativos no armazenamento—e você precisa que isso funcione esta semana. Ao final deste guia, você terá uma chamada funcional para um endpoint de produção que recebe uma URL pública de História ou Reel do Instagram e retorna a carga de mídia, usando uma chave de API do Zyla API Hub.
O que esta API faz e quando usá-la
A API do Instagram Stories Downloader expõe uma capacidade focada: dada a URL de um Reel ou História do Instagram, ela tenta resolver e retornar a mídia subjacente. Isso é útil para:
- Construir agendadores de mídia social que precisam buscar a mídia de origem antes de repostar.
- Fluxos de trabalho de moderação de conteúdo que extraem mídia para verificações automatizadas.
- Serviços de backup e arquivamento que preservam links do Instagram enviados pelos usuários.
- Pipelines de ingestão de dados que precisam de URLs de mídia determinísticas para processamento.
É parte da categoria de Mídias Sociais & Networking no Zyla API Hub, que oferece mais de 10.000 APIs prontas para uso sob uma conta e uma chave. A assinatura é baseada em cota (não paga por chamada). Para esta API, você pode começar com um teste de 7 dias ou 50 solicitações—verifique a página da API para opções de acesso e preços atuais.
Começando no Zyla API Hub
Para obter uma chave de API:
- Abra a listagem do marketplace para a API do Instagram Stories Downloader e inicie o teste.
- Inscreva-se para obter sua chave de API.
- Chame o endpoint com Authorization: Bearer YOUR_API_KEY.
Use este link direto para começar: Iniciar teste de 7 dias na API do Instagram Stories Downloader. Você também pode navegar por outras APIs de mídias sociais no Zyla API Hub.
Endpoint: Obter Histórias e Reels
Esta API expõe um único endpoint para recuperar mídia de uma URL de História ou Reel do Instagram fornecida.
- Método: GET
- URL: https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels
- Parâmetro de consulta obrigatório:
- url (string): A URL completa do Instagram da História ou Reel. Exemplo: https://www.instagram.com/reel/DL74pQBRymc/
- Autenticação: Cabeçalho HTTP Authorization: Bearer YOUR_API_KEY
Importante: codifique a URL do parâmetro ao construir a solicitação. O exemplo abaixo já inclui a codificação adequada.
Exemplo oficial de cURL
curl -s -X GET "https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FDL74pQBRymc%2F" \
-H "Authorization: Bearer YOUR_API_KEY"Exemplo de resposta oficial
{
"media": [],
"error": "Formato de link do Instagram inválido! Atualmente, suportamos apenas imagens, reels e IGTV."
}Notas de campo:
- media: Um array destinado a conter objetos de mídia resolvidos quando a URL é válida e suportada.
- error: Uma mensagem descrevendo o que deu errado quando a resolução falha (por exemplo, URL não suportada ou malformada).
Ao integrar, trate o erro como autoritário. Se o erro não estiver vazio ou a mídia estiver vazia, trate de forma adequada (por exemplo, solicite um link diferente, registre e tente novamente mais tarde, ou exiba uma mensagem de validação visível ao usuário).
Exemplo funcional em Python
O trecho abaixo chama o mesmo endpoint, analisa o JSON e demonstra o tratamento básico de erros. Substitua YOUR_API_KEY pela sua chave real da sua assinatura do Zyla API Hub.
import requests
import urllib.parse
API_KEY = "YOUR_API_KEY"
endpoint = "https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels"
# Sempre codifique a URL do link do Instagram para o parâmetro de consulta `url`
ig_link = "https://www.instagram.com/reel/DL74pQBRymc/"
params = {
"url": urllib.parse.quote(ig_link, safe="")
}
# Construa a URL final com o parâmetro codificado como a API espera
final_url = f"{endpoint}?url={params['url']}"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(final_url, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# Análise mínima: prefira `error` se presente, caso contrário use `media`
if data.get("error"):
print("A API relatou um erro:", data["error"])
else:
media_items = data.get("media", [])
print(f"Resolvido {len(media_items)} item(s) de mídia.")
# Exemplo de iteração (estrutura dos itens depende da resposta da API)
for i, item in enumerate(media_items, 1):
# Use o acesso ao dicionário de forma defensiva, uma vez que os campos não estão documentados aqui
# por exemplo, as chaves possíveis podem incluir 'url', 'type', etc. (verifique as respostas ao vivo)
print(f"Item {i}: {item}")Notas para desenvolvedores que economizam tempo
- Codificação de URL: Sempre codifique a URL do Instagram ao enviá-la como o parâmetro de consulta url. O curl acima mostra a codificação correta.
- Autenticação: Use um único cabeçalho—Authorization: Bearer YOUR_API_KEY. Não coloque sua chave na string de consulta.
- Validação de entrada: Valide se os usuários fornecem URLs completas do Instagram que representam Reels ou Histórias. A resposta de exemplo demonstra a mensagem de erro que você pode ver com links não suportados ou malformados.
- Tentativas: Se você receber erros HTTP transitórios, diminua a velocidade e tente novamente. Em um campo de erro consistente no corpo JSON, exiba-o para o usuário em vez de tentar novamente.
- Cache: Se seu fluxo de trabalho processa links populares repetidamente, armazene em cache as resoluções de mídia bem-sucedidas pela URL canônica do Instagram para reduzir solicitações duplicadas.
- Cotas: O acesso é por assinatura + cota (não paga por chamada). Para esta API, você pode começar com um teste de 7 dias ou 50 solicitações; verifique seus limites atuais na página de listagem antes de testar carga.
Casos de uso práticos
1) Ingestão de conteúdo social
Deixe os usuários colarem uma URL de Reel; resolva a mídia; faça o upload para seu armazenamento; anexe metadados; coloque na fila para transformação (por exemplo, transcodificação, recorte ou geração de miniaturas). Trate o caminho de erro mostrando um aviso claro quando a URL não for suportada.
2) Pipeline de moderação
Resolva a mídia de um link de Reel ou História e, em seguida, passe-a pelo seu stack de moderação. Com entrada consistente (uma única URL do Instagram), você pode padronizar o processamento e o registro em seus serviços.
3) Ferramentas para criadores
Construa um recurso simples de “importar do Instagram”, resolvendo Reels em uma linha do tempo de editor. Forneça feedback instantâneo quando a API sinalizar formatos de link não suportados através do campo de erro.
4) Arquivamento e backups
Quando os usuários fornecerem links como referências, use este endpoint para buscar mídia e arquivá-la com proveniência. Armazene a URL original do Instagram e o timestamp de resolução para auditoria.
Como chamá-lo de um agente de IA via MCP
Toda API no Zyla também pode ser chamada através do Protocolo de Contexto de Modelo (MCP), que funciona com ferramentas compatíveis com MCP. Aponte seu cliente para o gateway MCP em: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Dentro do seu cliente MCP, configure uma ferramenta que faça uma solicitação GET para:
- https://zylalabs.com/api/1435/instagram-stories-downloader-api/14849/get-stories-and-reels
- Cabeçalhos: Authorization: Bearer YOUR_API_KEY
- Parâmetro de consulta: url (link do Instagram codificado em URL)
Uma vez conectado, seu agente pode aceitar uma URL de Reel/História como entrada e retornar o JSON analisado (mídia ou erro) para sua sessão de codificação. Para material de referência sobre o MCP em si, veja: MCP.
Lista de verificação de ponta a ponta
- Obtenha uma chave de API assinando na página de listagem.
- Certifique-se de que a URL do Instagram esteja codificada em URL ao ser passada como url.
- Envie Authorization: Bearer YOUR_API_KEY em cada solicitação.
- Verifique o JSON em busca de erro; se presente, não assuma que a mídia está disponível.
- Registre a URL de entrada original e a resposta da API para depuração e auditorias.
- Armazene em cache resoluções bem-sucedidas com a URL canônica do Instagram.
FAQ
Quais tipos de conteúdo o endpoint suporta?
A mensagem de erro indica suporte para imagens, reels e IGTV. Se você passar um formato fora do que a API suporta ou um link inválido, espere uma mensagem de erro como a do exemplo de resposta.
Como faço para autenticar?
Inclua um cabeçalho HTTP: Authorization: Bearer YOUR_API_KEY. Não inclua chaves na string de consulta.
Preciso codificar a URL do link do Instagram?
Sim. O parâmetro de consulta url deve conter um link do Instagram codificado em URL. O exemplo oficial de curl mostra a codificação correta.
O que devo fazer quando a API retorna um campo de erro?
Trate o erro como o resultado autoritário para essa solicitação. Mostre uma mensagem de validação ao usuário, permita correção ou registre e interrompa o processamento. Evite tentar novamente se o erro indicar um formato não suportado.
Há um plano gratuito?
Não há plano gratuito. O acesso é por assinatura + cota, com uma opção de primeiro passo de um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso atuais.
Pronto para enviar sua integração de Reel/História do Instagram? Comece seu teste e obtenha sua chave de API aqui: API do Instagram Stories Downloader no Zyla API Hub. Uma vez inscrito, você pode fazer sua primeira solicitação em minutos e conectar a resposta aos seus fluxos de trabalho sociais.
