Schnellstart

Schick eine echte Anfrage, lies eine echte Antwort und bau das Ganze dann in deinen Code ein. Ein fehlgeschlagener Aufruf kostet nichts.

1. Schlüssel holen

Leg ein Konto an und erzeug auf der Schlüsselseite einen Schlüssel. Neue Konten starten mit 150 kostenlosen Credits. Die gibst du mit einem Live-Schlüssel in der echten API aus – nicht in einer Sandbox mit eigenen Daten.

Der Schlüssel wird nur einmal angezeigt und ausschließlich als Hash gespeichert. Wiederherstellen können wir ihn also nicht – leg ihn sofort in deinem Secret-Manager ab. Geht er verloren, erzeugst du einen neuen, statt den Support zu fragen.

2. Im Playground ausprobieren

Öffne den Playground, füg deinen Schlüssel ein, wähl einen Endpoint und klick auf Senden. Der Playground ruft mit deinem eigenen Schlüssel die echte API auf; ein fehlgeschlagener Aufruf kostet nichts. Mach das, bevor du eine Zeile Code schreibst: Es dauert ein paar Sekunden und zeigt dir, ob die Antwort enthält, was dein Produkt braucht.

3. Den Aufruf senden

Jeder Aufruf ist ein POST mit JSON-Body, authentifiziert über den Header X-API-Key. Diese Anfrage holt das heutige Panchang für Jaipur:

curl

curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"]
  }'

TypeScript

const response = await fetch(
  "https://api.occultapi.com/api/astro/panchanga/",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.OCCULT_API_KEY!,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      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"],
    }),
  },
);

const body = await response.json();
if (body.is_error) throw new Error(body.message);
console.log(body.data);

Python

import os, requests

response = requests.post(
    "https://api.occultapi.com/api/astro/panchanga/",
    headers={"X-API-Key": os.environ["OCCULT_API_KEY"]},
    json={
        "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"],
    },
)

body = response.json()
if body["is_error"]:
    raise RuntimeError(body["message"])
print(body["data"])

4. Die Antwort lesen

Jede Antwort hat dasselbe Format. Verzweige anhand von is_error; das Ergebnis steht unter data, geordnet nach den Keys, die du angefordert hast.

Antwort

{
  "data": {
    "tithi": {
      "paksha": "Shukla",
      "name": "Panchami",
      "number": 5,
      "start_time": "2026-09-15T02:15:17Z",
      "end_time": "2026-09-16T03:30:28Z",
      "remaining_time": { "hours": 3, "minutes": 0, "seconds": 28 }
    },
    "nakshatra_segments": [
      { "name": "Vishakha", "start_time": "2026-09-15T09:51:13.999999Z", "end_time": "2026-09-16T11:52:46.999999Z" },
      { "name": "Anuradha", "start_time": "2026-09-16T11:52:46.999999Z", "end_time": "2026-09-17T14:23:53.999999Z" }
    ],
    "yogam": "Vaidhriti",
    "karana": "Balava",
    "vaara": "Mangalavara"
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Wie die Felder aussehen, hängt vom Endpoint ab. Die meisten Endpoint-Seiten in der Referenz zeigen eine echte, aufgezeichnete Antwort statt einer erfundenen; die wenigen noch nicht geprüften sind entsprechend gekennzeichnet.

5. Prüfen, was es gekostet hat

Das steht in den Antwort-Headern, ein zweiter Aufruf ist also nicht nötig:

X-Credits-Cost:      1
X-Credits-Charged:   1     # 0 on any error — you are billed for answers
X-Credits-Remaining: 149

Frag mehrere keys in einer Anfrage ab, statt mehrere Anfragen zu senden. Der Preis ist derselbe – ein Aufruf mit fünf Berechnungen kostet also ein Fünftel von fünf einzelnen Aufrufen.

Keine Lust auf Boilerplate?

Verbinde einen KI-Assistenten mit unserem MCP-Server: Er kann die Endpoints durchsuchen, ein Anfrage-Schema lesen und den Aufruf selbst ausführen. Suchen und Lesen der Doku kostet keine Credits. Arbeitest du mit einem Coding-Agenten, gib ihm zuerst /agents. Einen typisierten Client in beliebiger Sprache generierst du aus der OpenAPI-Spezifikation.

Weiter

AuthentifizierungSchlüsselformate, Fehler, Rate-Limits und Rotation.API-ReferenzAlle Endpoints mit ihren Feldern und einem Beispiel.