Direkt zum Inhalt
Occult API
POST/api/planetary_details/1 Credit

Planetendetails

Ein einziger Aufruf, der neun separate Ephemeriden-Scans über einen Zeitraum ausführt und die Ergebnisse gemeinsam liefert. Diesen Endpoint nimmst du, wenn du statt einer Momentaufnahme alles brauchst, was zwischen zwei Daten bei den Planeten geschieht: Zeichen- und Nakshatra-Wechsel, rückläufige Phasen, Deklinationsübereinstimmungen und Phasen außerhalb der Deklinationsgrenzen (Out of Bounds). `start_date` und `end_date` begrenzen das Zeitfenster, `planet_name` und `sign` grenzen die drei planetenspezifischen Abschnitte ein, und `longitude` ist der ekliptikale Grad, den die Positionssuche prüft. Gibst du `geo_latitude` und `geo_longitude` an, kommt ein zusätzlicher Abschnitt für den Aszendenten-Ingress hinzu; sonst fehlt er. Beachte: Das Zeitfenster wird vollständig durchsucht, ein mehrjähriger Zeitraum dauert daher erheblich länger als wenige Tage. Die Antwort enthält folgende Schlüssel (mit Leerzeichen im Namen): `sign transitions`, `planet at position` (wann der genannte Planet auf der angegebenen Länge im angegebenen Zeichen steht), `planet ingress exit` (Ein- und Austrittszeiten nur für den genannten Planeten im genannten Zeichen), `planet nakshatra ingress exit` (mit allen siebenundzwanzig Nakshatras als Schlüsseln, jeweils eine Liste von `{start_date, end_date}`-Zeitfenstern), `planet sankranti times` (mit jedem unterstützten Himmelskörper als Schlüssel, einschließlich der uranischen Punkte und Planetenmonde), `planet retrogression dates` (mit den Planeten als Schlüsseln, jeweils eine Liste von `{start, end}`), `planet krantisamya dates` (eine Liste von `{Planet_1, Planet_2, DateTime, Alignment}`, wobei Alignment North-North, South-South oder Opposite ist, also gleiche oder gespiegelte Deklination), `abhijit nakshatra periods` und `planet oob range` (die Phasen, in denen der Himmelskörper jenseits der maximalen Deklination der Sonne steht). Leere Listen bedeuten, dass in deinem Zeitfenster nichts dieser Art geschehen ist.

https://api.occultapi.com/api/planetary_details/
Anfrage testen

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Felder der Anfrage

FeldTypPflichtHinweise
end_datestring (date-time)Pflicht
longitudenumber (double)Pflicht

Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China.

min -180 · max 180

planet_namestringPflicht
sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutotruenodemeannode

Eines von: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, truenode, meannode. Kleingeschrieben. Andere Namen von Himmelskörpern akzeptiert die Validierung zwar, dafür gibt es aber keine Daten, und die Anfrage schlägt fehl.

signstringPflicht
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

GROSS-/KLEINSCHREIBUNG WIRD BEACHTET – englische Zeichennamen mit großem Anfangsbuchstaben, exakt in dieser Schreibweise; 'aries' schlägt fehl. Wird außerdem genutzt, um das Ingress-/Exit-Ergebnis auf das angeforderte Zeichen einzuschränken.

start_datestring (date-time)Pflicht
geo_latitudenumber (double)optional

Geografischer Breitengrad des Beobachters (-90 bis 90). Erforderlich für die Daten zum Aszendenteneintritt.

min -90 · max 90

geo_longitudenumber (double)optional

Geografischer Längengrad des Beobachters (-180 bis 180). Erforderlich für die Daten zum Aszendenteneintritt.

min -180 · max 180

Beispielanfrage

curl -X POST https://api.occultapi.com/api/planetary_details/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_date":"2024-11-21T08:33:35.539Z","end_date":"2024-11-22T08:33:35.539Z","longitude":76.125,"planet_name":"mercury","sign":"Taurus"}'

Antwort

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"sign transitions\": {}, \"planet at position\": {\"mercury\": {\"positions\": []}}, \"planet ingress exit\": {\"mercury\": {}}, \"planet nakshatra ingress exit\": {\"mercury\": {\"Ashwini\": [], \"Bharani\": [], \"Krittika\": [], \"Rohini\": [], \"Mrigasira\": [], \"Aardra\": [], \"Punarvasu\": [], \"Pushyami\": [], \"Aasresha\": [], \"Makha\": [], \"Poorva Phalguni\": [], \"Uttara Phalguni\": [], \"Hasta\": [], \"Chitra\": [], \"Swaati\": [], \"Visaakha\": [], \"Anooraadha\": [], \"Jyeshtha\": [{\"start_date\": \"2024-11-21 08:33:35\", \"end_date\": \"2024-11-22 08:33:35\"}], \"Moola\": [], \"Poorvaashaadha\": [], \"Uttaraashaadha\": [], \"Sravanam\": [], \"Dhanishtha\": [], \"Satabhishak\": [], \"Poorvaabhaadra\": [], \"Uttaraabhaadra\": [], \"Revati\": []}}, \"planet sankranti times\": {\"sun\": [], \"moon\": [], \"mercury\": [], \"venus\": [], \"mars\": [], \"jupiter\": [], \"saturn\": [], \"uranus\": [], \"neptune\": [], \"pluto\": [], \"truenode\": [], \"meannode\": [], \"chiron\": [], \"pholus\": [], \"ceres\": [], \"pallas\": [], \"juno\": [], \"vesta\": [], \"cupido\": [], \"hades\": [], \"zeus\": [], \"kronos\": [], \"apollon\": [], \"admetos\": [], \"vulkanus\": [], \"poseidon\": [], \"selena\": [], \"phobos\": [], \"deimos\": [], \"io\": [], \"europa\": [], \"ganymede\": [], \"callisto\": [], \"titan\": [], \"triton\": [], \"charon\": []}, \"planet retrogression dates\": {\"jupiter\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"mars\": [], \"meannode\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"mercury\": [], \"moon\": [], \"neptune\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"pluto\": [], \"saturn\": [], \"sun\": [], \"truenode\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"uranus\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"venus\": []}, \"planet krantisamya dates\": [{\"Planet_1\": \"sun\", \"Planet_2\": \"truenode\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"meannode\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"zeus\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"Opposite\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"kronos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"apollon\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"Opposite\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"admetos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"vulkanus\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"poseidon\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"Opposite\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"selena\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"mercury\", \"Planet_2\": \"venus\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"mars\", \"Planet_2\": \"phobos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"mars\", \"Planet_2\": \"deimos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"io\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"europa\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"ganymede\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"callisto\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"saturn\", \"Planet_2\": \"titan\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"neptune\", \"Planet_2\": \"triton\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"pluto\", \"Planet_2\": \"charon\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"truenode\", \"Planet_2\": \"meannode\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"truenode\", \"Planet_2\": \"zeus\", \"DateTime\": \"2024-11-21 08:33"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.