API de données d’horoscope et d’astrologie pour partenaires
Une API JSON en lecture seule sur les mêmes éphémérides de haute précision qui font tourner Sigastra : horoscopes du jour, de la semaine et du mois pour les douze signes en quinze langues, plus la phase de la Lune en direct, les aspects planétaires du jour et la compatibilité des signes. Sans compte, sans clé, sans facture — la seule condition est l’attribution, et une balise canonical quand vous publiez le texte intégral.
Essayez
GET /api/v1/daily?lang=en&sign=leoS’exécute sur l’API en direct depuis votre navigateur. CORS est ouvert, c’est donc aussi un exemple fonctionnel d’intégration côté client.
Points d’accès
GET /api/v1/daily | lang, sign, full | L’horoscope du jour. Les douze signes, ou un seul. |
GET /api/v1/weekly | lang, sign, full | La semaine en cours, avec sa clé de période et son libellé de plage. |
GET /api/v1/monthly | lang, sign, full | Le mois en cours. |
GET /api/v1/moon | lang | Fraction éclairée, phase, croissante/décroissante, signe lunaire. Éphémérides pures. |
GET /api/v1/cosmic | lang | Les aspects planète à planète les plus serrés du jour, avec leurs orbes. Éphémérides pures. |
GET /api/v1/compat | lang, a, b | Compatibilité déterministe des signes : score, palier, relation d’élément et de modalité. |
Paramètres
- lang
- L’une des quinze langues servies (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Toute autre valeur bascule vers l’anglais au lieu de renvoyer une erreur.
- sign
- La clé anglaise (leo), le slug anglais (leo) ou le slug propre à la langue (lion). Omettez-le pour les douze.
- full
- full=1 renvoie le texte complet au lieu d’un extrait. C’est le mode syndication et il active l’obligation de canonical.
- a, b
- Uniquement pour compat. Deux signes, dans n’importe quelle forme acceptée.
Extrait ou texte intégral
Par défaut chaque élément porte un extrait — de quoi remplir une carte, une colonne ou une ligne de flux. Ajoutez full=1 et vous obtenez le corps complet, plus un objet sections correspondant à la page source. Le texte intégral est destiné à la republication : l’objet attribution passe donc canonicalRequired à true et vous remet la balise exacte à coller.
Limite de débit
10 requêtes par seconde et par IP, avec un pic à 30, appliqué en périphérie. Un partenaire de syndication interroge une fois par jour et par langue et ne la verra jamais. Il n’y a pas de plafond quotidien ni de quota à demander.
Exemples
curl -s "https://sigastra.com/api/v1/daily?lang=fr&sign=leo" | jq .
curl -s "https://sigastra.com/api/v1/weekly?lang=fr&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=fr&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.canonicalTagLes conditions, en entier
- Gratuit pour tout site, commercial ou non. Sans compte, sans clé, sans grille tarifaire.
- Affichez le lien visible « Powered by Sigastra », do-follow, pointant vers le localizedHref que nous renvoyons.
- Si vous publiez le texte INTÉGRAL, ajoutez le canonicalTag du payload dans le <head> de cette page.
- Ne présentez pas le contenu comme calculé par vous — il est calculé, et l’attribution est ce qui rend cette affirmation vérifiable.
FAQ de l’API
L’API d’horoscope est-elle vraiment gratuite ?+
Oui — sans compte, sans clé, sans facture, y compris pour les sites commerciaux. Les conditions sont l’attribution et, pour le texte intégral, une balise canonical.
Ai-je besoin d’une clé d’API ?+
Non. Les points d’accès fonctionnent sans clé et sont limités en débit en périphérie. La forme de la réponse porte déjà tout ce à quoi une clé se rattacherait plus tard : en ajouter une ne casserait pas votre intégration.
Quelle est la limite de débit ?+
10 requêtes par seconde et par IP, avec un pic à 30. Il n’y a pas de plafond quotidien.
Puis-je republier tout l’horoscope ?+
Oui, avec full=1 — et vous devez alors ajouter la balise canonical que le payload vous donne. Sans elle, deux pages identiques se concurrencent et un moteur en choisit une ; la canonical est ce qui empêche ce choix d’être un tirage au sort.
Quelles langues l’API d’astrologie couvre-t-elle ?+
Quinze : en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Les noms de signes, de planètes, d’aspects et de phases sont tous localisés.
Les données sont-elles calculées ou rédigées ?+
Calculées. La phase de la Lune et les aspects sortent directement des éphémérides ; le texte de l’horoscope est généré chaque jour à partir des positions planétaires réelles de ce jour puis mis en cache — l’API ne génère jamais sur votre requête, elle lit ce qui est déjà là.
Tout ici est gratuit. La seule condition est un lien do-follow visible — plus une balise canonique si vous publiez le texte intégral.