Horóscopos: pasado, presente y futuro

API de horóscopos gratis

La API de horóscopos de Zodiac Timeline le da a tu app horóscopos diarios nuevos de los 12 signos del zodiaco. Es gratis, está abierta a todos los sitios y no necesita clave de API. Solo tienes que dar crédito a Zodiac Timeline.

Una sola solicitud GET lo devuelve todo:

https://zodiactimeline.com/feed.xml

Es la misma dirección de nuestro feed RSS de horóscopos. Una API es una dirección web que un programa llama para obtener datos.

La API en resumen

• Endpoint: GET https://zodiactimeline.com/feed.xml
• Formato: XML en el estándar RSS 2.0, más nuestros campos zt: para signo, fecha y puntuación.
• Acceso: sin clave, sin cuenta y sin registro.
• Llamadas desde el navegador: abierta a todos los sitios web (CORS). CORS es la regla del navegador que decide qué sitios pueden leer los datos.
• Datos: 60 horóscopos: los 12 signos durante cinco días. Los días son dos días atrás, hoy y dos días adelante.
• Actualización: una vez al día a la medianoche UTC.
• Precio: gratis, con un crédito visible.

Pruébala desde la línea de comandos:

curl https://zodiactimeline.com/feed.xml

Respuesta de la API

Cada horóscopo de la respuesta es un item con estos campos:

• title: el signo y la fecha, como “Leo · October 13, 2026”.
• link: la página de ese signo y ese día en Zodiac Timeline el día en que se creó el feed, como /leo/today/ o /leo/tomorrow/.
• guid: el signo y la fecha, como leo-2026-10-13. Es el mismo para ese item todos los días.
• pubDate: la fecha del horóscopo, en el formato de fecha de RSS.
• description: el horóscopo completo de ese día, como texto simple.
• zt:sign: el signo en minúsculas, como leo. Úsalo para elegir un signo.
• zt:date: la fecha del horóscopo, como 2026-10-13.
• zt:score: la puntuación general del día, sobre 10.

Así se ve un item (aquí la lectura está recortada):

<item>
  <title>Leo · October 13, 2026</title>
  <link>https://zodiactimeline.com/leo/today/</link>
  <guid isPermaLink="false">leo-2026-10-13</guid>
  <pubDate>Tue, 13 Oct 2026 00:00:00 +0000</pubDate>
  <description>This is a good time to ask what makes you feel safe and how much of it you actually have. …</description>
  <zt:sign>leo</zt:sign>
  <zt:date>2026-10-13</zt:date>
  <zt:score>3.5</zt:score>
</item>

Los horóscopos de la API están en inglés.

Código de ejemplo

Nuestro repositorio en GitHub tiene ejemplos cortos y listos para usar en Python y Node.js. Leen la API y muestran los horóscopos: free-horoscope-api-examples

Componente para React: react-horoscope

react-horoscope es nuestro componente gratis y de código abierto para React, la popular biblioteca de JavaScript para crear páginas web. Pone los 12 signos en tu página con una sola línea de código. Lee este mismo feed, directo en el navegador.

npm install react-horoscope

Luego agrégalo a tu app:

import { Horoscope } from 'react-horoscope';
import 'react-horoscope/styles.css';

export default function App() {
  return <Horoscope />;
}

Lo que obtienes:

• Una cuadrícula con los 12 signos. Toca un signo para abrir su lectura de hoy. Ayer y mañana están a un toque.
• La fecha del visitante. “Hoy” sigue el reloj del dispositivo del visitante, en cualquier zona horaria.
• Una puntuación diaria. Cada signo muestra su puntuación del día, sobre 10.
• Pequeño y rápido. Pesa unos 6 KB comprimido y no necesita otros paquetes. Una página hace una sola petición al feed, sin importar cuántas veces aparezca el componente.
• Tu estilo. Elige tema claro, oscuro o automático, tarjetas o mosaicos, y tus propios colores. Cada color y tamaño es una variable CSS que puedes cambiar.
• Hooks para tu propio diseño. Un hook es una función de React que te entrega los datos. Usa useHoroscope para obtener la lectura de un signo y crea el diseño tú mismo.
• Hecho para apps modernas. Está escrito en TypeScript, así que los editores de código revisan tu código mientras escribes. Funciona con React 17 y versiones posteriores.
• Seguro en sitios estrictos. No ejecuta scripts en línea, así que funciona con una Content Security Policy estricta (una regla del navegador que bloquea código desconocido).
• Fácil para todos. Quienes usan teclado o lector de pantalla no pierden su lugar al pasar de un signo a otro.
• Crédito incluido. El componente muestra el enlace “Powered by Zodiac Timeline” por ti.

Es gratis con la licencia MIT, así que puedes usarlo en proyectos personales y de pago.

• Pruébalo: demo en vivo
• Instálalo: react-horoscope en npm
• Lee el código: react-horoscope en GitHub

Buenas prácticas

• Guarda los datos por un día. Los datos cambian una vez al día, así que basta con una llamada al día.
• Llámala desde donde quieras. Tu servidor, una tarea programada o el navegador de un visitante funcionan.
• Usa la fecha del visitante. La respuesta tiene cinco días, así que “hoy” está ahí en cualquier zona horaria.

Da crédito a Zodiac Timeline

Muestra el nombre Zodiac Timeline cerca de los horóscopos, donde tus lectores puedan verlo. Haz que el nombre sea un enlace a https://zodiactimeline.com como en este HTML:

<a href="https://zodiactimeline.com">Zodiac Timeline</a>

El componente para React muestra este crédito por ti. Este permiso forma parte de nuestros Términos de uso.

Lo que viene: la plataforma de astrología completa

Zodiac Timeline está creciendo hasta ser una plataforma de astrología completa, y cada parte será una API sobre la que puedes construir. En camino:

• Carta natal: los planetas, signos, casas y aspectos de cualquier fecha, hora y lugar de nacimiento. Los aspectos son los ángulos entre planetas.
• Pronóstico personal: lecturas diarias según cómo los planetas de hoy tocan la carta natal de una persona.
• Relaciones: cómo funcionan juntas dos cartas natales, día a día. Los astrólogos llaman a esto sinastría.
• Puntuaciones diarias: puntuaciones de amor, trabajo y energía para cada día.
• Eventos del cielo: retrógrados, eclipses, fases de la luna y planetas que cambian de signo, con horas exactas.
• Astrología védica y china: los otros dos grandes sistemas, con los mismos datos del cielo.
• Mejores fechas: los días más fuertes por venir para una meta.

¿Quieres acceso anticipado o una alianza? Contáctanos.