Direkt zum Inhalt

API-Dokumentation

Alle Endpoints mit dem genauen Anfrage-Body und einer Beispielantwort – bei den meisten direkt von einem laufenden Server aufgezeichnet. Deinen Schlüssel schickst du im Header X-API-Key. Jeder erfolgreiche Aufruf kostet einen Credit, egal was du darin abfragst. Ausnahmen sind die beiden PDF-Berichte und der Chat-Endpoint: Sie kosten 25.

https://api.occultapi.com

Was mit diesen Endpoints entsteht

Oberflächen, die auf der API aufbauen. Welcher Endpoint jeweils dahintersteckt, steht auf der Karte.

299 Endpoints, 330 durchsuchbare Funktionen

KI & Chat

PDF-Berichte

Panchang

Muhurta & Zeitfenster

Sonnen- & Mondaufgang

Mond

Kalender

Feste & Vrats

Geburtshoroskop & Häuser

Teilhoroskope (Vargas)

Jaimini

KP (Krishnamurti Paddhati)

Chakras

Planeten & Positionen

Stärke (Bala)

Ashtakavarga

Dashas – Nakshatra (Planeten)

Dashas – Rashi (Jaimini)

Dasha-Werkzeuge

Yogas & Doshas

Lal Kitab

Horoskopvergleich & Kompatibilität

Transite & Jahreshoroskope

Tajika & Varshaphala

Suchläufe & Wechsel

Prognosen & Deutungen

Prashna

Tarot

Pancha Pakshi

Wiederkehrhoroskope

Finsternisse

Mundanastrologie

Fixsterne

Traditionell & hellenistisch

Westliche Astrologie

Numerologie

Chinesische Astrologie

Astrokartografie

Human Design

Naturereignisse

Hilfsfunktionen

Astrologie

Prashnavali

Fehlerreferenz

StatusCodeBedeutungLösung
401invalid_api_keyDer Schlüssel ist falsch, widerrufen oder abgelaufen.Prüf den Header X-API-Key. Nach einer Rotation den neuen Schlüssel deployen.
402insufficient_creditsDer Schlüssel ist gültig, aber deine Credits sind aufgebraucht.Tarif upgraden oder auf das monatliche Zurücksetzen warten. Das ist kein Authentifizierungsproblem – erzeug keinen neuen Schlüssel.
403endpoint_not_allowedDiese Route steht API-Schlüsseln nicht zur Verfügung: Pfad oder Methode stimmen nicht, oder der Endpoint wurde abgeschaltet.Gleich Route und Methode mit der Referenz ab. Ein neuer Versuch hilft nicht.
403scope_not_allowedDeinem Schlüssel fehlt der Scope, den dieser Endpoint braucht.Erstell einen Schlüssel mit den passenden Scopes oder lass die Scopes leer – dann gelten alle.
403ip_not_allowedDer Schlüssel hat eine IP-Allowlist, und die Anfrage kam von einer anderen Adresse.Ruf von einer freigegebenen IP aus auf oder erstell einen Schlüssel mit den richtigen IPs.
403account_suspendedDas Konto ist gesperrt, deshalb werden alle seine Schlüssel abgewiesen.Wende dich an den Support. Ein neuer Schlüssel hilft nicht.
429api_key_rate_limitedZu viele Anfragen innerhalb einer Minute.Kurz pausieren und nach den Sekunden aus Retry-After erneut versuchen.
400(Feldfehler)Der Anfrage-Body war fehlerhaft.message lesen – dort steht jedes betroffene Feld. Wird nie berechnet.