Necesitas obtener un horóscopo para un signo solar específico en una fecha específica y conectarlo a tu aplicación esta semana. Al final de esta guía, podrás recuperar los horóscopos de hoy y pasados por fecha, listar los signos/intervalos de tiempo soportados y obtener entradas diarias/semanales/mensuales, utilizando puntos finales listos para producción en Zyla API Hub.
Qué hace esta API y cuándo usarla
La API de Horóscopos en Zyla API Hub proporciona acceso programático al texto del horóscopo para signos solares a través de múltiples intervalos de tiempo. Soporta:
- Recuperar un horóscopo para una fecha específica (hoy o pasada) usando una fecha en formato AAAA-MM-DD.
- Obtener horóscopos diarios, semanales, mensuales y del día de la semana por intervalo de tiempo.
- Listar los signos solares y intervalos de tiempo soportados, para que tu interfaz de usuario pueda validar entradas y evitar errores del usuario.
Las integraciones comunes incluyen notificaciones diarias, chatbots, paneles personales y widgets de contenido que necesitan acceso determinista al horóscopo de un día particular.
Comenzando en Zyla API Hub
Abre la página de la API de Horóscopos en Zyla API Hub y suscríbete para obtener tu clave API. El acceso es basado en suscripción con cuotas (no pago por llamada), y puedes comenzar con una prueba de 7 días en la página de listado. Enviarás solicitudes con el encabezado Authorization: Bearer YOUR_API_KEY.
Listado de API: Iniciar prueba de 7 días en la API de Horóscopos
También puedes explorar miles de otras APIs listas para usar en el hub: Zyla API Hub.
Puntos finales que usarás
1) Obtener Símbolos
Verifica los signos solares y intervalos de tiempo soportados para validar la entrada del usuario y configurar tus controles de UI.
- Método: GET
- URL: https://zylalabs.com/api/891/horoscope-api/2450/get-symbols
- Parámetros: ninguno documentado
- Auth: Authorization: Bearer YOUR_API_KEY
curl -s -X GET "https://zylalabs.com/api/891/horoscope-api/694/get-horoscope?sunsign=gemini&timeframe=daily" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"status": 200,
"success": true,
"sunSigns": "gemini",
"timeFrames": "daily",
"Horoscope": "2 de septiembre de 2026 - ¿Es hora de entregar esos papeles de despido? Con la luna en tu duodécima casa de sanación y cierre, ha llegado el momento de cortar lazos con una situación tóxica. Eso nunca es tan fácil como suena, así que apóyate en las personas que te respaldan, ya sea un familiar o un miembro de tu familia elegida. La luna está formando un trígono de apoyo con Mercurio en tu acogedora cuarta casa, lo que pone el autocuidado cerca de la parte superior de tus prioridades hoy. ¿Considerando un movimiento? Revisa los listados en tu descanso para el almuerzo, pero piensa bien en cualquier cosa que requiera una firma."
}
Usa esto para llenar menús desplegables y validar valores antes de llamar a otros puntos finales.
2) Obtener Horóscopo
Recupera los horóscopos de hoy, semanales, mensuales o del día de la semana especificando un signo solar y un intervalo de tiempo.
- Método: GET
- URL: https://zylalabs.com/api/891/horoscope-api/694/get-horoscope
- Parámetros requeridos:
- sunsign (cadena): por ejemplo, gemini
- timeframe (cadena): por ejemplo, daily
- Auth: Authorization: Bearer YOUR_API_KEY
Campos que típicamente usarás: - sunSigns: el signo solar que solicitaste - timeFrames: el intervalo de tiempo que solicitaste - Horoscope: el contenido de texto para mostrar o procesar
3) Por Fecha
Recupera un horóscopo para una fecha específica (incluyendo hoy o una fecha pasada) para un signo solar dado. Este es el punto final principal cuando necesitas “API para por fecha.”
- Método: GET
- URL: https://zylalabs.com/api/891/horoscope-api/3527/by-date
- Parámetros requeridos:
- sunsign (cadena): por ejemplo, gemini
- date (cadena): por ejemplo, 2024-01-02 (formato AAAA-MM-DD)
- Auth: Authorization: Bearer YOUR_API_KEY
Campos que típicamente usarás: - sunSigns: el signo solar que solicitaste - date: la fecha que solicitaste (AAAA-MM-DD) - Horoscope: el contenido de texto para esa fecha
Ejemplo en Python para Por Fecha
Este ejemplo llama al punto final Por Fecha y imprime los campos devueltos. Reemplaza YOUR_API_KEY con tu clave de la página de listado.
import requests
API_KEY = "YOUR_API_KEY"
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("Fecha:", data.get("date"))
print("Horóscopo:", data.get("Horoscope"))
else:
print("La solicitud no tuvo éxito:", data)
Notas de implementación que ahorran tiempo
- Formato de fecha: pasa la fecha en AAAA-MM-DD para el punto final Por Fecha (por ejemplo, 2024-01-02).
- Validación de entrada: llama a Obtener Símbolos al inicio para llenar y validar signos solares e intervalos de tiempo. Esto reduce errores del tipo 400/422 por entradas inválidas.
- Cacheo: si sirves a muchos usuarios el mismo contenido (por ejemplo, el mismo signo y fecha), almacena en caché las respuestas para minimizar llamadas redundantes y acelerar la carga de páginas.
- Manejo de respuestas: verifica los campos de éxito y estado antes de usar el texto del Horóscopo. Registra cargas no exitosas para solucionar problemas.
- Auth: siempre envía Authorization: Bearer YOUR_API_KEY en cada solicitud.
- Modelo de uso: las APIs de Zyla utilizan planes de suscripción con cuotas (no pago por llamada). La página de listado muestra las opciones de acceso actuales, incluyendo una prueba de 7 días para esta API.
Casos de uso prácticos
- Tarjeta diaria en una aplicación móvil: muestra el horóscopo de hoy por intervalo de tiempo con Obtener Horóscopo, y permite a los usuarios ver los días anteriores con Por Fecha.
- Resúmenes por correo electrónico: crea un resumen que incluya ayer y hoy para un signo seleccionado; obtén cada uno a través de Por Fecha.
- Fallback de chatbot: si un usuario pregunta, “¿Qué fue Géminis el 2024-01-02?”, dirígete a Por Fecha y devuelve el texto exacto.
- Archivo de contenido: almacena las respuestas de Por Fecha para que los usuarios puedan navegar por entradas históricas para su signo.
- Integración de widget: valida previamente signos/intervalos de tiempo una vez a través de Obtener Símbolos, luego llama a Por Fecha para un historial determinista.
Llamando a la API desde agentes de IA a través de MCP
Puedes llamar a las APIs de Zyla desde clientes compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf) utilizando el punto final MCP. Proporciona tu clave API en la cadena de consulta al inicializar la herramienta:
Punto final para agentes: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Aprende más sobre MCP aquí: MCP. Una vez configurado, indica a tu agente que llame al punto final Por Fecha con los parámetros requeridos de signo solar y fecha, o que obtenga Obtener Símbolos primero para validar entradas.
Ejemplo de flujo de extremo a extremo
- Al iniciar la aplicación, llama a Obtener Símbolos para recuperar sunSigns y timeFrames. Almacénalos en caché para la validación del formulario.
- Cuando un usuario solicita una fecha específica, llama a Por Fecha con el signo solar y la fecha en AAAA-MM-DD.
- Si un usuario solicita “hoy”, llama a Por Fecha con la fecha de hoy o usa Obtener Horóscopo con timeframe=daily.
- Muestra data.Horoscope. Opcionalmente muestra los sunSigns y date/timeFrames solicitados para confirmar el contexto al usuario.
- Almacena en caché los resultados por clave (sunsign, date/timeframe) para reducir llamadas repetidas.
Lista de verificación de seguridad y operaciones
- Almacena YOUR_API_KEY de forma segura (variables de entorno o tu gestor de secretos).
- Establece tiempos de espera en las solicitudes HTTP para fallar rápido y degradar de manera elegante.
- Registra estados HTTP no 200 y cargas donde el éxito es falso para depuración.
- Si pre-renderizas páginas, agrupa llamadas y reutiliza respuestas en caché para mantenerte dentro de las cuotas del plan.
Referencia: solicitudes cURL listas para copiar
Obtener Símbolos (signos y intervalos de tiempo soportados):
Obtener Horóscopo (basado en intervalo de tiempo):
Por Fecha (día específico):
FAQ
¿Qué formato de fecha requiere Por Fecha?
Usa AAAA-MM-DD (por ejemplo, 2024-01-02) en el parámetro de fecha.
¿Cómo sé qué signos solares e intervalos de tiempo son válidos?
Llama al punto final Obtener Símbolos para recuperar las listas autorizadas de sunSigns y timeFrames, luego valida la entrada del usuario contra esos arreglos.
¿Puedo recuperar el horóscopo de hoy por fecha y por intervalo de tiempo?
Sí. Para un día calendario específico, usa Por Fecha con la fecha de hoy. Para una experiencia de “hoy” sin especificar una fecha, usa Obtener Horóscopo con timeframe=daily.
¿Cuál es el método de autenticación?
Envía Authorization: Bearer YOUR_API_KEY en el encabezado de la solicitud para todos los puntos finales.
¿El precio es por llamada?
No. Las APIs de Zyla utilizan planes de suscripción con cuotas. Consulta la página de la API para las opciones de acceso actuales y precios.
Implementa tu integración “por fecha” ahora: abre el listado, inicia la prueba de 7 días y obtén tu clave. Iniciar prueba de 7 días en la API de Horóscopos. Explora más APIs en cualquier momento en Zyla API Hub.