Einführung

Das Panchang mit seinen fünf Elementen, Kundli und die Teilhoroskope D2 bis D60, dreißig Dasha-Systeme, Yogas und Doshas, Muhurat-Zeitfenster, Ashtakavarga, Planetenstärken, Horoskopvergleich, Numerologie in dreizehn Systemen und elf regionale Kalender samt ihren Festen.

Alles wird für Datum, Uhrzeit und Koordinaten aus deiner Anfrage berechnet – ein vorberechneter Almanach steckt nicht dahinter. Fast alle Endpoints liefern Zahlen und klassische Einordnungen, keine ausformulierten Deutungen. Nur wenige liefern Text: der Chat-Endpoint, die allgemeinen Vorhersagen, Rashifal und die PDF-Berichte.

Meist verhält sich die API so, wie du es erwartest. Bei diesen drei Punkten nicht – und genau die kosten am meisten Zeit.

Viele Endpoints erwarten ein Array keys, in dem du die gewünschten Berechnungen aufzählst. Ein einziger Aufruf von /api/astro/panchanga/ kann so jedes von 57 verschiedenen Ergebnissen liefern.

Alle zusammen kosten nur einen Credit. Alles Nötige in einem Aufruf abzufragen ist also der günstige Weg, nicht der teure. Der eigentliche Fehler wäre, denselben Endpoint fünfmal für fünf Keys aufzurufen. Jede Endpoint-Seite listet ihre gültigen Keys auf, und die Referenz lässt sich nach Berechnung wie nach Route durchsuchen. So findest du eine Funktion, auch ohne zu wissen, welcher Endpoint sie liefert.

{
  "date_time": "2026-09-16T06:00:00+05:30",
  "latitude": 26.9124,
  "longitude": 75.7873,
  "timezone_as_float": 5.5,
  "keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"]
}

Jede JSON-Antwort hat dieselben vier Felder. Verzweige anhand von is_error, lies data und zeig message an, wenn etwas schiefgeht. Die Meldung nennt die fehlerhaften Felder, statt nur „ungültige Anfrage“ zu sagen.

{
  "data":     { ... },        // the result; shape varies by endpoint
  "status":   200,
  "is_error": false,
  "message":  "successful"
}

Ein Credit pro erfolgreichem Aufruf; die beiden PDF-Berichte und der Chat-Endpoint kosten 25. Ein 4xx, ein 5xx oder ein Timeout kostet nichts: Der Credit wird vor der Berechnung reserviert und wieder freigegeben, wenn sie kein sauberes Ergebnis liefert. Eine fehlerhafte Integration kann dein Guthaben also nicht leerräumen, während du sie debuggst.

Der Zugang läuft über einen Monats- oder Jahrestarif. Sein Kontingent wird jeden Monat zurückgesetzt, und nicht genutzte Aufrufe werden nicht übertragen. Es gibt keine Gebühr pro Nutzer, und du kannst jederzeit kündigen. Jede Antwort enthält X-Credits-Charged und X-Credits-Remaining, so behältst du dein Guthaben ohne zweiten Aufruf im Blick.

Die Positionen stammen aus NASA-JPL-Ephemeriden: der vollständige Datensatz, 735 Fixsterne, getestet von 500 bis 2999 n. Chr. Die Antwortzeit auf dem Server liegt im Median bei 62 ms – gemessen über alle veröffentlichten Beispiele, nicht über ein handverlesenes. Die langsamen Endpoints sind aufwendige Suchläufe und als solche dokumentiert.

Beim Ayanamsa sind sich die indischen Traditionen wirklich uneins. Deshalb bietet die API 48 davon an, und du kannst jedes auf Grad, Minute und Sekunde genau korrigieren. Die Wahl triffst du selbst und erklärst sie deinen Nutzern. Wir nehmen sie dir nicht ab, indem wir eines ausliefern und es zum richtigen erklären.

Sie rechnet, sie berät nicht. Nichts, was sie zurückgibt, ist medizinischer, rechtlicher oder finanzieller Rat, und abgesehen von den wenigen Endpoints, die Text liefern, schreibt sie keine Deutungen. Wenn dein Produkt auf dieser Basis Empfehlungen ausspricht, ist das deine redaktionelle Entscheidung. Was du mit der Ausgabe tun darfst, steht in der Lizenz.

Die Basis-URL lautet https://api.occultapi.com. Neben reinem HTTP gibt es einen Playground, der echte Aufrufe mit deinem eigenen Schlüssel ausführt (ein fehlgeschlagener Aufruf kostet nichts), eine Postman-Collection, eine OpenAPI-3.1-Spezifikation zum Generieren eines Clients und einen MCP-Server, über den ein KI-Assistent die API direkt aufrufen kann.