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 ni facture ; les appels côté serveur indiquent votre site (son adresse ou une clé gratuite). 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 en périphérie, pic à 30, et un plafond quotidien de 1 500 requêtes par adresse. Un éditeur qui interroge douze signes en quotidien, hebdomadaire et mensuel, quatre fois par jour, en consomme environ 150 : vous n’atteindrez ni l’une ni l’autre limite. Au-delà du plafond, la réponse est un HTTP 429 avec un lien vers cette page. Besoin de plus de volume ? Écrivez à info@sigastra.com en nous disant où le contenu est publié.
Exemples
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=fr&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "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.canonicalTagChaînes Telegram, étape par étape
- Ouvrez sigastra.com/api/partners/verify?site=t.me/votrechaine. La chaîne doit être publique ; vous recevez sa clé gratuite tout de suite, et l’essai de trois jours commence au premier appel.
- Votre bot appelle l’API avec la clé, par exemple /api/v1/daily?lang=fr&sign=leo&key=VOTRE_CLE, et publie le texte (raccourci ou traduit, c’est possible, voir les conditions).
- Au moins une de vos dix dernières publications renvoie vers sigastra.com avec le mot « Sigastra », sans intervalle de plus de sept jours. Nous vérifions automatiquement l’aperçu public de la chaîne.
FAQ de l’API
L’API d’horoscope est-elle vraiment gratuite ?+
Oui, sur n’importe quel site, commercial ou non. Vous disposez de trois jours d’essai à partir de votre premier appel. Ensuite, votre page est vérifiée automatiquement toutes les quelques heures : sans le lien, le contenu est suspendu, et il revient dès que le lien est de nouveau mesuré. Pour vérifier tout de suite, ouvrez sigastra.com/api/partners/verify?site=votredomaine.fr.
Ai-je besoin d’une clé d’API ?+
Les appels depuis un navigateur (les widgets, ou une page qui interroge elle-même l’API) envoient seuls l’adresse de leur page et n’ont besoin de rien d’autre. Les appels depuis votre serveur doivent indiquer pour quel site est le contenu : envoyez l’adresse de cette page dans l’en-tête Referer (notre extension WordPress le fait pour vous). Dès que votre site a passé la vérification du lien, l’adresse de vérification vous donne aussi une clé gratuite. À partir du 15 octobre 2026, un appel serveur qui n’envoie ni l’un ni l’autre est refusé.
Quelle est la limite de débit ?+
10 requêtes par seconde et par IP en périphérie, pic à 30, plus un plafond quotidien de 1 500 requêtes par adresse. Un éditeur en consomme environ 150 par jour et n’atteindra ni l’un ni l’autre. Au-delà : HTTP 429: pour plus de volume, écrivez à info@sigastra.com.
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 ?+
Les deux. Les positions des planètes, la phase de la Lune et les aspects sont calculés à partir des éphémérides. Le texte de l’horoscope est écrit une fois par jour par une IA (Claude, d’Anthropic) à partir des positions calculées ce jour-là, puis mis en cache : l’API n’écrit jamais rien à votre demande, elle lit ce qui existe déjà.
Puis-je l’utiliser dans une application mobile ?+
Pas dans une application native. Le programme est gratuit parce que le contenu se trouve sur une page ou une chaîne publique qui porte le lien, et une application n’a ni l’une ni l’autre. Un site web ou une chaîne Telegram publique conviennent ; pour tout le reste, écrivez à info@sigastra.com.
Tout ici est gratuit. La seule condition est un lien visible: plus une balise canonique si vous publiez le texte intégral.
Comment fonctionne le gratuit
- 3 jours pour tester : pendant ce temps, aucun lien n’est encore requis.
- À partir du jour 4: un lien visible vers sigastra.com dont le texte contient le mot «Sigastra», sur la page qui affiche le contenu, lisible par tous sans connexion. Votre langue convient: «Powered by Sigastra», «Horoscope fourni par Sigastra» ou simplement «Sigastra». Pas dans le cadre du widget et pas caché. Ajouter rel="nofollow" reste votre choix.
- Sans lui, le contenu se met en pause sur toutes les surfaces (widget, images, JSON) et la réponse indique exactement quoi ajouter. Nous mesurons votre page en ligne automatiquement.
Lien ajouté? Ouvrez /api/partners/verify?site=votre-domaine.fr et le contenu reprend en quelques minutes. Une clé partenaire gratuite est attribuée à votre site automatiquement dès que le lien est mesuré.