Horoskop- & Astrologie-Daten-API
Eine lesende JSON-API auf derselben hochpräzisen Ephemeriden, 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, keine Rechnung; serverseitige Aufrufe nennen Ihre Website (Adresse oder kostenloser Schlüssel). 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 | Das Horoskop von heute. Alle zwölf Zeichen oder eines. |
GET /api/v1/weekly | lang, sign, full | Die laufende Woche, mit Periodenschlüssel und Zeitraum-Label. |
GET /api/v1/monthly | lang, sign, full | Der laufende Monat. |
GET /api/v1/moon | lang | Beleuchteter Anteil, Phase, zunehmend/abnehmend, Mondzeichen. Reine Ephemeride. |
GET /api/v1/cosmic | lang | Die engsten Planet-zu-Planet-Aspekte des Tages, mit Orben. Reine Ephemeride. |
GET /api/v1/compat | lang, a, b | Deterministische Zeichen-Kompatibilität: Wert, Band, Element- und Modalitätsbeziehung. |
Parameter
- lang
- Eine der fünfzehn ausgelieferten Sprachen (en, de, tr, ro, pl, es, sr, hr, nl, sl, pt-BR, fr, it, ja, id). Alles andere fällt auf Englisch zurück, statt einen Fehler zu liefern.
- sign
- Der englische Schlüssel (leo), der englische Slug (leo) oder der eigene Slug der Sprache (loewe). Weglassen für alle zwölf.
- full
- full=1 liefert den vollständigen Text statt eines Teasers. Das ist der Syndication-Modus, und er schaltet die Canonical-Pflicht ein.
- a, b
- Nur für compat. Zwei Zeichen, in einer der akzeptierten Formen.
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 am Edge, Burst 30, dazu ein Tageslimit von 1.500 Anfragen pro Adresse. Ein Publisher, der zwölf Zeichen über Tages-, Wochen- und Monatsprognose viermal täglich abruft, verbraucht rund 150. Sie werden keines der beiden Limits erreichen. Oberhalb des Tageslimits antwortet die API mit HTTP 429 und einem Link auf diese Seite. Mehr Volumen nötig? Schreiben Sie an info@sigastra.com und sagen Sie uns, wo die Inhalte laufen.
Beispiele
curl -s -H "Referer: https://example.com/horoscope" "https://sigastra.com/api/v1/daily?lang=de&sign=leo" | jq .
curl -s -H "x-sigastra-key: YOUR_KEY" "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.canonicalTagTelegram-Kanäle Schritt für Schritt
- Öffnen Sie sigastra.com/api/partners/verify?site=t.me/ihrkanal. Der Kanal muss öffentlich sein; Sie erhalten seinen kostenlosen Schlüssel sofort, und die dreitägige Testphase beginnt mit dem ersten Aufruf.
- Ihr Bot ruft die API mit dem Schlüssel auf, zum Beispiel /api/v1/daily?lang=de&sign=leo&key=IHR_SCHLUESSEL, und veröffentlicht den Text (gekürzt oder übersetzt ist in Ordnung, siehe Bedingungen).
- Mindestens einer Ihrer letzten zehn Beiträge verlinkt auf sigastra.com mit dem Wort „Sigastra“, ohne eine Lücke von mehr als sieben Tagen. Die öffentliche Vorschau des Kanals prüfen wir automatisch.
API-FAQ
Ist die Horoskop-API wirklich kostenlos?+
Ja, auf jeder Website, kommerziell oder nicht. Ab Ihrem ersten Aufruf haben Sie drei Tage zum Testen. Danach wird Ihre Seite alle paar Stunden automatisch geprüft: Ohne den Link pausiert der Inhalt, und er kommt zurück, sobald der Link wieder gemessen wird. Für eine sofortige Prüfung öffnen Sie sigastra.com/api/partners/verify?site=ihredomain.de.
Brauche ich einen API-Schlüssel?+
Aufrufe aus dem Browser (Widgets oder eine Seite, die die API selbst abruft) senden ihre Seitenadresse von selbst und brauchen nichts weiter. Aufrufe von Ihrem Server müssen sagen, für welche Website der Inhalt bestimmt ist: Senden Sie die Adresse dieser Seite als Referer-Header (unser WordPress-Plugin erledigt das für Sie). Sobald Ihre Website die Linkprüfung bestanden hat, erhalten Sie über die Prüfadresse auch einen kostenlosen Schlüssel. Ab dem 15. Oktober 2026 wird ein Serveraufruf, der weder das eine noch das andere sendet, abgelehnt.
Wie hoch ist das Rate-Limit?+
10 Anfragen pro Sekunde und IP am Edge, Burst 30, dazu ein Tageslimit von 1.500 Anfragen pro Adresse. Ein Publisher verbraucht rund 150 am Tag, erreicht also keines von beiden. Oberhalb: HTTP 429: für mehr Volumen schreiben Sie an info@sigastra.com.
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?+
Beides. Planetenpositionen, Mondphase und Aspekte werden aus den Ephemeriden berechnet. Den Horoskoptext schreibt einmal am Tag eine KI (Claude von Anthropic) aus den berechneten Positionen dieses Tages, danach wird er zwischengespeichert: Die API schreibt auf Ihre Anfrage nie etwas, sie liest nur, was schon da ist.
Darf ich die Inhalte in einer mobilen App verwenden?+
Nicht in einer nativen App. Das Programm ist kostenlos, weil die Inhalte auf einer öffentlichen Seite oder in einem öffentlichen Kanal mit Link stehen, und eine App hat weder das eine noch das andere. Eine Website oder ein öffentlicher Telegram-Kanal ist in Ordnung; für alles andere schreiben Sie an info@sigastra.com.
Alles hier ist kostenlos. Bedingung ist ein sichtbarer Link: beim Volltext zusätzlich ein Canonical-Tag.
So funktioniert „kostenlos“
- 3 Tage zum Testen: in dieser Zeit ist noch kein Link nötig.
- Ab Tag 4: ein sichtbarer Link auf sigastra.com, dessen Text das Wort „Sigastra“ enthält, auf der Seite, die den Inhalt zeigt, für jeden ohne Login lesbar. Ihre Sprache ist in Ordnung: „Powered by Sigastra“, „Horoskop von Sigastra“ oder einfach „Sigastra“. Nicht im Widget-Frame und nicht versteckt. Ob Sie rel="nofollow" setzen, bleibt Ihnen überlassen.
- Ohne ihn pausiert der Inhalt auf allen Flächen (Widget, Bilder, JSON) und die Antwort sagt genau, was fehlt. Wir messen Ihre Live-Seite automatisch.
Link gesetzt? /api/partners/verify?site=ihre-domain.de öffnen, und der Inhalt läuft innerhalb von Minuten weiter. Ein kostenloser Partner-Schlüssel wird Ihrer Seite automatisch ausgestellt, sobald der Link gemessen ist.