POST/api/astro/attributes/1 Credit

Horoskopattribute

Ein Sammelsurium aus zwölf kleinen Horoskopgrößen in einem Aufruf – Werte, für die du sonst ein Dutzend Anfragen bräuchtest. Es werden immer alle zwölf berechnet, egal was du sendest. Enthalten sind: Nakshatra und Pada einer gegebenen ekliptikalen Länge, Nummer und herrschender Planet eines Nakshatras anhand seines Namens, der Hadda-Herrscher (ägyptischer Termin) einer Länge innerhalb eines Zeichens, Kakshya-Herrscher und Kakshya-Nummer, das Tierkreiszeichen einer Länge, die zum gegebenen Zeitpunkt verbrannten Planeten, der Phasenwinkel des Mondes, der nächste Eintritt einer gewählten Mondphase, die vier jahreszeitlichen Ingress-Zeitpunkte eines Jahres und eine aus einer Länge abgeleitete Position im Teilhoroskop. Nur `date_time` ist erforderlich; alles andere hat einen Standardwert (longitude 0, name 'Ashwini', zodiac 'Aries', lord 'saturn', target_phase 0 für Neumond, limitdays 30, das aktuelle Jahr, chart_factor 1 für das Rashi-Horoskop). Schon ein minimaler Aufruf mit `date_time` und `longitude` liefert also verbrannte Planeten, Mondphase, Nakshatra und Zeichen. Zwei Eigenheiten: `lord` wird unter Beachtung der Groß-/Kleinschreibung mit Daten abgeglichen, in denen Mercury großgeschrieben ist – 'mercury' liefert daher stillschweigend null, 'Mercury' dagegen eine Zahl. Und die Anfragefelder `when` und `nakshatras` werden zwar akzeptiert, aber nie gelesen.

https://api.occultapi.com/api/astro/attributes/

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

Feld	Typ	Pflicht	Hinweise
date_time	string (date-time)	Pflicht	Der Zeitpunkt, für den gerechnet wird, im Format ISO 8601. Gib IMMER einen Offset oder ein abschließendes Z an – ein Wert ohne Zone wird als Asia/Kolkata (UTC+05:30) gelesen, nicht als UTC, und kann mit Status 200 das Ergebnis des Vortags liefern. '2026-09-01T06:00:00Z' und '2026-09-01 06:00:00' sind verschiedene Zeitpunkte und ergeben verschiedene Antworten. FORMATVORGABE, kein Enum. DRF DateTimeField: nur ISO-8601 (Standard-Eingabeformate von DRF), z. B. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" oder "2026-09-01 06:00:00" (ohne Zeitzone wird UTC angenommen).
chart_factor	integer	optional	Teilungsfaktor des Teilhoroskops für dasavarga_from_longitude (1=Rashi, 9=Navamsa usw.).
limitdays	integer	optional	Suchfenster in Tagen für search_moon_phase.
longitude	number (double)	optional	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
lord	string	optional	Planet als Herrscher, mit dem get_kakshya_number rechnet. `saturnjupitermarssunvenusMercurymoonascendant` Exakter Abgleich, Groß-/Kleinschreibung wird BEACHTET. Die Daten selbst sind uneinheitlich: Sieben Einträge sind kleingeschrieben, aber Merkur ist mit großem Anfangsbuchstaben als 'Mercury' gespeichert, sodass 'mercury' stillschweigend null liefert, während 'Mercury' 6 liefert. Ein nicht passender Wert liefert null ohne Fehler. Standard: 'saturn'.
nakshatras	string	optional
name	string	optional	Nakshatra-Name, mit dem get_nakshatra_details arbeitet. `AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishtha` Nakshatra-Name für das Ergebnis `nakshatra_details`. Ohne Beachtung der Groß-/Kleinschreibung; Leerzeichen am Anfang und Ende werden entfernt. Erkannt werden sowohl die modernen Schreibweisen (Mrigashira, Ardra, Pushya, Ashlesha, Magha, Purva Phalguni, Swati, Vishakha, Anuradha, Purva Ashadha, Uttara Ashadha, Shravana, Dhanishta, Shatabhisha, Purva Bhadrapada, Uttara Bhadrapada) als auch die älteren Transliterationen des Rechenkerns (Mrigasira, Aardra, Pushyami, Aasresha, Makha, Poorva Phalguni, Swaati, Visaakha, Anooraadha, Poorvaashaadha, Uttaraashaadha, Sravanam, Dhanishtha, Satabhishak, Poorvaabhaadra, Uttaraabhaadra). 'Abhijit' wird akzeptiert (Schema mit 28 Nakshatras). Standard: 'Ashwini'.
target_phase	integer	optional	Gesuchte Mondphase: 0=Neumond, 1=erstes Viertel, 2=Vollmond, 3=letztes Viertel.
when	string	optional
year	integer	optional	Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern.
zodiac	string	optional	Tierkreiszeichen, mit dem get_hadda_lord rechnet. `AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces`

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/attributes/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2024-11-21T07:45:44.368Z","longitude":76.125,"name":"Ashwini","zodiac":"Aries","lord":"saturn","target_phase":0,"limitdays":30,"year":1,"chart_factor":1}'

Antwort

{
  "data": {
    "nakshatra_pada": [
      "Aardra",
      3
    ],
    "nakshatra_details": [
      1,
      "Ketu"
    ],
    "hadda_lord": null,
    "kakshya_lord": "venus",
    "kakshya_number": 1,
    "zodiac_name": "Gemini",
    "combust_planets": {
      "Mars": false,
      "Mercury": false,
      "Venus": false,
      "Jupiter": false,
      "Saturn": false
    },
    "moon_phase": 250.14160858923307,
    "search_moon_phase": "2024-12-01T06:22:06Z",
    "seasons": {
      "spring_equinox": "0001-03-20T21:39:01Z",
      "summer_solstice": "0001-06-22T20:51:18Z",
      "autumnal_equinox": "0001-09-23T07:34:54Z",
      "winter_solstice": "0001-12-21T00:14:00Z"
    },
    "dasavarga_from_longitude": {
      "constellation": 2,
      "longitude": 16.125
    },
    "get_nakshatra_name": "Aardra"
  },
  "message": "successful",
  "is_error": false
}

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.