Horoskop- & Astrologie-Daten-API
Eine lesende JSON-API auf derselben Swiss-Ephemeris-Engine, die Sigastra antreibt: Tages-, Wochen- und Monatshoroskope für alle zwölf Sternzeichen in fünfzehn Sprachen, dazu die aktuelle Mondphase, die heutigen Planetenaspekte und die Sternzeichen-Kompatibilität. Kein Konto, kein Schlüssel, keine Rechnung — Bedingung sind die Attribution und, beim vollständigen Text, ein Canonical-Tag.
Ausprobieren
GET /api/v1/daily?lang=en&sign=leoLäuft live gegen die API, direkt aus Ihrem Browser. CORS ist offen — das hier ist zugleich ein funktionierendes Beispiel für eine clientseitige Integration.
Endpunkte
GET /api/v1/daily | lang, sign, full | Today’s horoscope. All twelve signs, or one. |
GET /api/v1/weekly | lang, sign, full | The current week, with its period key and range label. |
GET /api/v1/monthly | lang, sign, full | The current month. |
GET /api/v1/moon | lang | Illuminated fraction, phase, waxing/waning, moon sign. Pure ephemeris. |
GET /api/v1/cosmic | lang | The day’s closest planet-to-planet aspects, with orbs. Pure ephemeris. |
GET /api/v1/compat | lang, a, b | Deterministic sign compatibility: score, band, element and modality relation. |
Parameter
- lang
- One of the fifteen served languages (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Anything else falls back to English rather than erroring.
- sign
- The English key (leo), the English slug (leo) or the locale’s own slug (loewe). Omit it for all twelve.
- full
- full=1 returns the complete text instead of a teaser. This is the syndication mode and it turns the canonical requirement on.
- a, b
- Compat only. Two signs, in any of the accepted forms.
Teaser oder Volltext
Standardmäßig liefert jedes Element einen Teaser — genug für eine Karte, eine Sidebar oder eine Feed-Zeile. Mit full=1 bekommen Sie den vollständigen Text plus ein sections-Objekt, das der Quellseite entspricht. Volltext ist zum Weiterveröffentlichen gedacht, deshalb setzt das attribution-Objekt canonicalRequired auf true und liefert das exakte Tag zum Einfügen mit.
Rate-Limit
10 Anfragen pro Sekunde und IP, Burst 30, am Edge durchgesetzt. Ein Syndication-Partner ruft einmal täglich pro Sprache ab und wird es nie sehen. Kein Tageslimit, kein Kontingent zu beantragen.
Beispiele
curl -s "https://sigastra.com/api/v1/daily?lang=de&sign=leo" | jq .
curl -s "https://sigastra.com/api/v1/weekly?lang=de&sign=leo&full=1" | jq '.attribution.canonicalTag'
const res = await fetch("https://sigastra.com/api/v1/daily?lang=de&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.canonicalTagDie Bedingungen, vollständig
- Kostenlos für jede Website, kommerziell oder nicht. Kein Konto, kein Schlüssel, keine Preisliste.
- Den sichtbaren Do-follow-Link „Powered by Sigastra“ ausgeben, auf den zurückgegebenen localizedHref.
- Beim VOLLSTÄNDIGEN Text das canonicalTag aus der Antwort in den <head> der Seite setzen.
- Die Inhalte nicht als selbst berechnet ausgeben — sie sind berechnet, und die Attribution macht diese Aussage überprüfbar.
API-FAQ
Ist die Horoskop-API wirklich kostenlos?+
Ja — kein Konto, kein Schlüssel, keine Rechnung, auch für kommerzielle Seiten. Die Bedingungen sind Attribution und, beim Volltext, ein Canonical-Tag.
Brauche ich einen API-Schlüssel?+
Nein. Die Endpunkte sind schlüssellos und werden stattdessen am Edge limitiert. Die Antwortstruktur trägt bereits alles, woran ein Schlüssel später hängen würde — Ihre Integration bricht dadurch nicht.
Wie hoch ist das Rate-Limit?+
10 Anfragen pro Sekunde und IP, Burst 30. Es gibt kein Tageslimit.
Darf ich das komplette Horoskop weiterveröffentlichen?+
Ja, mit full=1 — dann müssen Sie das mitgelieferte Canonical-Tag setzen. Ohne es konkurrieren zwei identische Seiten und Suchmaschinen wählen eine aus; das Canonical verhindert genau dieses Glücksspiel.
Welche Sprachen deckt die Astrologie-API ab?+
Fünfzehn: en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id. Sternzeichen-, Planeten-, Aspekt- und Phasennamen sind alle lokalisiert.
Sind die Daten berechnet oder geschrieben?+
Berechnet. Mondphase und Aspekte kommen direkt aus der Ephemeride; die Horoskoptexte werden täglich aus den echten Planetenständen dieses Tages erzeugt und zwischengespeichert — die API erzeugt auf Ihre Anfrage hin nie etwas, sie liest, was bereits da ist.
Alles hier ist kostenlos. Bedingung ist ein sichtbarer Do-follow-Link — beim Volltext zusätzlich ein Canonical-Tag.