Você precisa buscar um horóscopo para um signo solar específico em uma data específica e integrá-lo ao seu aplicativo esta semana. Ao final deste guia, você será capaz de recuperar os horóscopos de hoje e passados por data, listar os signos/períodos suportados e puxar entradas diárias/semanal/mensais—usando endpoints prontos para produção no Zyla API Hub.
O que esta API faz e quando usá-la
A API de Horóscopo no Zyla API Hub fornece acesso programático ao texto do horóscopo para signos solares em múltiplos períodos. Ela suporta:
- Recuperar um horóscopo para uma data específica (hoje ou passada) usando uma data no formato AAAA-MM-DD.
- Buscar horóscopos diários, semanais, mensais e do dia da semana por período.
- Listar os signos solares e períodos suportados, para que sua interface possa validar entradas e evitar erros do usuário.
Integrações comuns incluem notificações diárias, chatbots, painéis pessoais e widgets de conteúdo que precisam de acesso determinístico ao horóscopo de um dia específico.
Começando no Zyla API Hub
Abra a página da API de Horóscopo no Zyla API Hub e inscreva-se para obter sua chave de API. O acesso é baseado em assinatura com cotas (não pago por chamada), e você pode começar com um teste de 7 dias na página de listagem. Você enviará solicitações com o cabeçalho Authorization: Bearer SUA_CHAVE_API.
Listagem da API: Comece o teste de 7 dias na API de Horóscopo
Você também pode navegar por milhares de outras APIs prontas para uso no hub: Zyla API Hub.
Endpoints que você usará
1) Obter Símbolos
Verifique os signos solares e períodos suportados para validar a entrada do usuário e configurar seus controles de interface.
- Método: GET
- URL: https://zylalabs.com/api/891/horoscope-api/2450/get-symbols
- Parâmetros: nenhum documentado
- Auth: Authorization: Bearer SUA_CHAVE_API
curl -s -X GET "https://zylalabs.com/api/891/horoscope-api/694/get-horoscope?sunsign=gemini&timeframe=daily" \
-H "Authorization: Bearer SUA_CHAVE_API"
{
"status": 200,
"success": true,
"sunSigns": "gemini",
"timeFrames": "daily",
"Horoscope": "2 de setembro de 2026 - É hora de entregar aqueles papéis de demissão? Com a lua na sua décima segunda casa de cura e fechamento, o momento chegou de cortar laços com uma situação tóxica. Isso nunca é tão fácil quanto parece, então confie nas pessoas que estão ao seu lado, seja um parente ou um membro da sua família escolhida. A lua está formando um trígono de apoio com Mercúrio na sua quarta casa acolhedora, o que coloca o autocuidado perto do topo das suas prioridades hoje. Considerando uma mudança? Navegue pelas listagens durante seu intervalo para o almoço, mas pense bem antes de assinar qualquer coisa."
}
Use isso para preencher dropdowns e validar valores antes de chamar outros endpoints.
2) Obter Horóscopo
Recupere os horóscopos de hoje, semanais, mensais ou do dia da semana especificando um signo solar e um período.
- Método: GET
- URL: https://zylalabs.com/api/891/horoscope-api/694/get-horoscope
- Parâmetros obrigatórios:
- sunsign (string): por exemplo, gemini
- timeframe (string): por exemplo, daily
- Auth: Authorization: Bearer SUA_CHAVE_API
Campos que você normalmente usará: - sunSigns: o signo solar que você solicitou - timeFrames: o período que você solicitou - Horoscope: o conteúdo de texto para exibição ou processamento
3) Por Data
Recupere um horóscopo para uma data específica (incluindo hoje ou uma data passada) para um dado signo solar. Este é o endpoint principal quando você precisa de “API por data.”
- Método: GET
- URL: https://zylalabs.com/api/891/horoscope-api/3527/by-date
- Parâmetros obrigatórios:
- sunsign (string): por exemplo, gemini
- date (string): por exemplo, 2024-01-02 (formato AAAA-MM-DD)
- Auth: Authorization: Bearer SUA_CHAVE_API
Campos que você normalmente usará: - sunSigns: o signo solar que você solicitou - date: a data que você solicitou (AAAA-MM-DD) - Horoscope: o conteúdo de texto para essa data
Exemplo em Python para Por Data
Este exemplo chama o endpoint Por Data e imprime os campos retornados. Substitua SUA_CHAVE_API pela sua chave da página de listagem.
import requests
API_KEY = "SUA_CHAVE_API"
url = "https://zylalabs.com/api/891/horoscope-api/3527/by-date"
params = {
"sunsign": "gemini",
"date": "2024-01-02"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
data = resp.json()
if data.get("success"):
print("Signo solar:", data.get("sunSigns"))
print("Data:", data.get("date"))
print("Horóscopo:", data.get("Horoscope"))
else:
print("A solicitação não foi bem-sucedida:", data)
Notas de implementação que economizam tempo
- Formato da data: passe a data no formato AAAA-MM-DD para o endpoint Por Data (por exemplo, 2024-01-02).
- Validação de entrada: chame Obter Símbolos na inicialização para preencher e validar signos solares e períodos. Isso reduz erros do tipo 400/422 de entradas inválidas.
- Cache: se você atender muitos usuários com o mesmo conteúdo (por exemplo, o mesmo signo e data), armazene em cache as respostas para minimizar chamadas redundantes e acelerar o carregamento das páginas.
- Tratamento de resposta: verifique os campos de sucesso e status antes de usar o texto do Horóscopo. Registre cargas não bem-sucedidas para solução de problemas.
- Auth: sempre envie Authorization: Bearer SUA_CHAVE_API em cada solicitação.
- Modelo de uso: as APIs Zyla usam planos de assinatura com cotas (não pago por chamada). A página de listagem mostra as opções de acesso atuais, incluindo um teste de 7 dias para esta API.
Casos de uso práticos
- Carta diária em um aplicativo móvel: mostre o horóscopo de hoje por período com Obter Horóscopo, e deixe os usuários visualizarem os dias anteriores com Por Data.
- Resumos por e-mail: crie um resumo que inclua ontem e hoje para um signo selecionado; busque cada um via Por Data.
- Fallback de chatbot: se um usuário perguntar, “Qual foi o horóscopo de Gêmeos em 2024-01-02?”, redirecione para Por Data e retorne o texto exato.
- Arquivo de conteúdo: armazene as respostas de Por Data para que os usuários possam navegar por entradas históricas para seu signo.
- Incorporação de widget: valide previamente signos/períodos uma vez via Obter Símbolos, depois chame Por Data para um histórico determinístico.
Chamando a API de agentes de IA via MCP
Você pode chamar as APIs Zyla de clientes compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf) usando o endpoint MCP. Forneça sua chave de API na string de consulta ao inicializar a ferramenta:
Endpoint para agentes: https://mcp.zylalabs.com/mcp?apikey=SUA_CHAVE_API
Saiba mais sobre o MCP aqui: MCP. Uma vez configurado, solicite ao seu agente que chame o endpoint Por Data com os parâmetros de signo solar e data necessários, ou para buscar Obter Símbolos primeiro para validar entradas.
Exemplo de fluxo de ponta a ponta
- Ao iniciar o aplicativo, chame Obter Símbolos para recuperar sunSigns e timeFrames. Armazene-os em cache para validação de formulário.
- Quando um usuário solicitar uma data específica, chame Por Data com signo solar e data no formato AAAA-MM-DD.
- Se um usuário solicitar “hoje”, chame Por Data com a data de hoje ou use Obter Horóscopo com timeframe=daily.
- Exiba data.Horoscope. Opcionalmente, mostre os sunSigns e data/timeFrames solicitados para confirmar o contexto ao usuário.
- Armazene os resultados por chave (sunsign, data/timeframe) para reduzir chamadas repetidas.
Checklist de segurança e operações
- Armazene SUA_CHAVE_API de forma segura (variáveis de ambiente ou seu gerenciador de segredos).
- Defina timeouts em solicitações HTTP para falhar rapidamente e degradar de forma graciosa.
- Registre status HTTP não 200 e cargas onde o sucesso é falso para depuração.
- Se você pré-renderizar páginas, agrupe chamadas e reutilize respostas em cache para permanecer dentro das cotas do plano.
Referência: solicitações cURL prontas para copiar
Obter Símbolos (signos e períodos suportados):
Obter Horóscopo (baseado em período):
Por Data (dia específico):
FAQ
Qual formato de data o Por Data requer?
Use AAAA-MM-DD (por exemplo, 2024-01-02) no parâmetro de data.
Como sei quais signos solares e períodos são válidos?
Chame o endpoint Obter Símbolos para recuperar as listas autorizadas de sunSigns e timeFrames, e então valide a entrada do usuário contra esses arrays.
Posso recuperar o horóscopo de hoje por data e por período?
Sim. Para um dia específico do calendário, use Por Data com a data de hoje. Para uma experiência de “hoje” sem especificar uma data, use Obter Horóscopo com timeframe=daily.
Qual é o método de autenticação?
Envie Authorization: Bearer SUA_CHAVE_API no cabeçalho da solicitação para todos os endpoints.
O preço é pago por chamada?
Não. As APIs Zyla usam planos de assinatura com cotas. Verifique a página da API para opções de acesso e preços atuais.
Implemente sua integração “por data” agora: abra a listagem, comece o teste de 7 dias e obtenha sua chave. Comece o teste de 7 dias na API de Horóscopo. Explore mais APIs a qualquer momento em Zyla API Hub.