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 y sin factura (las llamadas desde servidor indican tu sitio: su dirección o una clave gratuita): la única condición es la atribución, y una etiqueta canonical cuando publiques el texto completo.
Pruébalo
GET /api/v1/daily?lang=en&sign=leoSe 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 en el borde, ráfaga de 30, y un tope diario de 1.500 peticiones por dirección. Un editor que consulta doce signos entre diario, semanal y mensual, cuatro veces al día, gasta unas 150: no llegará a ninguno de los dos límites. Por encima del tope la respuesta es HTTP 429 con un enlace a esta página. ¿Necesita más volumen? Escriba a info@sigastra.com y díganos dónde se publica el contenido.
Ejemplos
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=es&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "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.canonicalTagCanales de Telegram, paso a paso
- Abre sigastra.com/api/partners/verify?site=t.me/tucanal. El canal debe ser público; recibes su clave gratuita al momento, y la prueba de tres días empieza con la primera llamada.
- Tu bot llama a la API con la clave, por ejemplo /api/v1/daily?lang=es&sign=leo&key=TU_CLAVE, y publica el texto (acortado o traducido está bien, consulta las condiciones).
- Al menos una de tus diez últimas publicaciones enlaza a sigastra.com con la palabra «Sigastra», sin un hueco de más de siete días. Comprobamos automáticamente la vista previa pública del canal.
Preguntas frecuentes sobre la API
¿La API de horóscopo es realmente gratuita?+
Sí, en cualquier sitio, comercial o no. Tienes tres días de prueba desde tu primera llamada. Después tu página se revisa automáticamente cada pocas horas: sin el enlace el contenido se pausa, y vuelve en cuanto el enlace se mide de nuevo. Para revisarla al momento, abre sigastra.com/api/partners/verify?site=tudominio.com.
¿Necesito una clave de API?+
Las llamadas desde el navegador (los widgets o una página que consulta la API por sí misma) envían solas la dirección de su página y no necesitan nada más. Las llamadas desde tu servidor tienen que decir para qué sitio es el contenido: envía la dirección de esa página como cabecera Referer (nuestro plugin de WordPress lo hace por ti). Cuando tu sitio supera la comprobación del enlace, la dirección de verificación también te da una clave gratuita. Desde el 15 de octubre de 2026 se rechaza una llamada de servidor que no envíe ni lo uno ni lo otro.
¿Cuál es el límite de velocidad?+
10 peticiones por segundo por IP en el borde, ráfaga de 30, más un tope diario de 1.500 peticiones por dirección. Un editor gasta unas 150 al día, así que no llegará a ninguno. Por encima: HTTP 429; para más volumen, escriba a info@sigastra.com.
¿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?+
Las dos cosas. Las posiciones de los planetas, la fase lunar y los aspectos se calculan a partir de las efemérides. El texto del horóscopo lo escribe una vez al día una IA (Claude, de Anthropic) a partir de las posiciones calculadas de ese día y después se guarda en caché: la API nunca escribe nada a petición tuya, solo lee lo que ya existe.
¿Puedo usarlo en una aplicación móvil?+
No en una aplicación nativa. El programa es gratuito porque el contenido está en una página o un canal público que lleva el enlace, y una aplicación no tiene ni lo uno ni lo otro. Un sitio web o un canal público de Telegram está bien; para cualquier otra cosa, escribe a info@sigastra.com.
Todo aquí es gratuito. La única condición es un enlace visible: más una etiqueta canónica si publicas el texto completo.
Cómo funciona lo gratuito
- 3 días para probar: durante ese tiempo todavía no hace falta el enlace.
- Desde el día 4: un enlace visible a sigastra.com cuyo texto contenga la palabra "Sigastra", en la página que muestra el contenido, legible por cualquiera sin iniciar sesión. Tu idioma vale: "Powered by Sigastra", "Horóscopo por Sigastra" o solo "Sigastra". No dentro del marco del widget ni oculto. Añadir rel="nofollow" es tu decisión.
- Sin él, el contenido se pausa en todas las superficies (widget, imágenes, JSON) y la respuesta dice exactamente qué añadir. Medimos tu página en vivo automáticamente.
¿Ya pusiste el enlace? Abre /api/partners/verify?site=tu-dominio.com y el contenido vuelve en minutos. Tu sitio recibe una clave de partner gratuita automáticamente en cuanto se mide el enlace.