API de datos de horóscopo y astrología para socios

Una API JSON de solo lectura sobre las mismas efemérides de alta precisión que mueven Sigastra: horóscopos diarios, semanales y mensuales para los doce signos en quince idiomas, además de fase lunar en vivo, aspectos planetarios de hoy y compatibilidad de signos. Sin cuenta, sin clave, sin factura: la única condición es la atribución, y una etiqueta canonical cuando publiques el texto completo.

Pruébalo

full=1

GET /api/v1/daily?lang=en&sign=leo

Se ejecuta contra la API en vivo desde tu navegador. CORS está abierto, así que esto es además un ejemplo funcional de integración en el cliente.

Endpoints

`GET /api/v1/daily`	lang, sign, full	El horóscopo de hoy. Los doce signos, o uno.
`GET /api/v1/weekly`	lang, sign, full	La semana actual, con su clave de periodo y etiqueta de rango.
`GET /api/v1/monthly`	lang, sign, full	El mes actual.
`GET /api/v1/moon`	lang	Fracción iluminada, fase, creciente/menguante, signo lunar. Efemérides puras.
`GET /api/v1/cosmic`	lang	Los aspectos planeta a planeta más cerrados del día, con orbes. Efemérides puras.
`GET /api/v1/compat`	lang, a, b	Compatibilidad determinista de signos: puntuación, franja, relación de elemento y modalidad.

Parámetros

lang: Uno de los quince idiomas servidos (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Cualquier otro cae a inglés en lugar de dar error.
sign: La clave inglesa (leo), el slug inglés (leo) o el slug propio del idioma (leo). Omítelo para los doce.
full: full=1 devuelve el texto completo en lugar de un adelanto. Es el modo de sindicación y activa la obligación de canonical.
a, b: Solo para compat. Dos signos, en cualquiera de las formas aceptadas.

Adelanto o texto completo

Por defecto cada elemento lleva un adelanto: suficiente para una tarjeta, una barra lateral o una fila de feed. Añade full=1 y obtienes el cuerpo completo, más un objeto sections que coincide con la página de origen. El texto completo está pensado para republicar, así que el objeto attribution pone canonicalRequired en true y te entrega la etiqueta exacta para pegar.

Límite de velocidad

10 peticiones por segundo por IP, con una ráfaga de 30, aplicado en el borde. Un socio de sindicación consulta una vez al día por idioma y nunca lo verá. No hay tope diario ni cuota que solicitar.

Ejemplos

curl -s "https://sigastra.com/api/v1/daily?lang=es&sign=leo" | jq .

curl -s "https://sigastra.com/api/v1/weekly?lang=es&sign=leo&full=1" | jq '.attribution.canonicalTag'

const res = await fetch("https://sigastra.com/api/v1/daily?lang=es&sign=leo");
const { items, attribution } = await res.json();

document.querySelector("#horoscope").textContent = items[0].text;
document.querySelector("#credit").outerHTML =
  `<a href="${attribution.localizedHref}">${attribution.text}</a>`;

// Publishing the FULL text (full=1)? Also put this in <head>:
// attribution.canonicalTag

Las condiciones, completas

Gratis para cualquier sitio, comercial o no. Sin cuenta, sin clave, sin tarifa.
Muestra el enlace visible “Powered by Sigastra”, do-follow, apuntando al localizedHref que devolvemos.
Si publicas el texto COMPLETO, añade el canonicalTag del payload al <head> de esa página.
No presentes el contenido como calculado por ti: está calculado, y la atribución es lo que hace comprobable esa afirmación.

Preguntas frecuentes sobre la API

¿La API de horóscopo es realmente gratuita?+

Sí: sin cuenta, sin clave, sin factura, también para sitios comerciales. Las condiciones son la atribución y, para el texto completo, una etiqueta canonical.

¿Necesito una clave de API?+

No. Los endpoints funcionan sin clave y se limitan por velocidad en el borde. La forma de la respuesta ya lleva todo aquello a lo que una clave se engancharía después, así que añadirla no rompería tu integración.

¿Cuál es el límite de velocidad?+

10 peticiones por segundo por IP con una ráfaga de 30. No hay tope diario.

¿Puedo republicar el horóscopo entero?+

Sí, con full=1, y entonces debes añadir la etiqueta canonical que te da el payload. Sin ella, dos páginas idénticas compiten y el buscador elige una; el canonical es lo que evita que esa elección sea a cara o cruz.

¿Qué idiomas cubre la API de astrología?+

Quince: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Los nombres de signos, planetas, aspectos y fases están localizados.

¿Los datos están calculados o escritos?+

Calculados. La fase lunar y los aspectos salen directamente de las efemérides; el texto del horóscopo se genera cada día a partir de las posiciones planetarias reales de ese día y se cachea: la API nunca genera con tu petición, lee lo que ya está ahí.

Todo aquí es gratuito. La única condición es un enlace do-follow visible — más una etiqueta canónica si publicas el texto completo.

Widgets →Sindicación →WordPress →Resumen →