Direkt zum Inhalt
POST/api/astro/planet_insights/1 Credit

Deutungen von Planetenplatzierungen

Vorformulierte Deutungen für einen einzelnen Planeten in einer bestimmten Stellung. Gib einen Planeten an und wo er steht – in einem Tierkreiszeichen, einem Haus oder einem Nakshatra –, und du erhältst die klassische Deutung für diese Kombination. Der Endpoint schlägt in einem Textkorpus nach, er rechnet nicht: Datum, Uhrzeit und Ort spielen keine Rolle, und dieselbe Anfrage liefert immer denselben Text. Damit beschriftest du ein Horoskop, das du bereits berechnet hast. Hol dir Zeichen, Haus und Nakshatra von Jupiter aus `/api/astro/chart/` und rufe dann diesen Endpoint für den Text auf. Alle drei Keys lassen sich in einem Aufruf anfordern, aber jeder braucht seinen eigenen zusätzlichen Parameter: Forderst du alle drei an, müssen `planet`, `sign`, `house` und `nakshatra` alle im Body stehen. Abgedeckt sind neun Planeten (die sieben klassischen plus Rahu und Ketu) in zwölf Zeichen und zwölf Häusern. Nakshatra-Deutungen gibt es nur für die sieben klassischen Planeten – für Rahu und Ketu nicht. Ein unbekannter Planet, ein unbekanntes Zeichen, Haus oder Nakshatra liefert keinen Fehler, sondern einen erklärenden String mit HTTP 200; prüfe also den Typ der Antwort, bevor du sie renderst.

https://api.occultapi.com/api/astro/planet_insights/
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
houseintegerPflicht
keysarrayPflicht

Welche Berechnungen zurückgegeben werden, als Liste von Namen. Siehe die Key-Tabelle dieses Endpoints; ein unbekannter Name lässt die ganze Anfrage scheitern. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also alles, was du brauchst, auf einmal an, statt mehrere Aufrufe zu machen.

nakshatrastringPflicht
ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguni

Die Liste oben gilt für jupiter, mercury, venus und saturn. Für 'rahu' und 'ketu' gibt es überhaupt keine Nakshatra-Daten. Nicht passende Werte liefern "Invalid nakshatra: <x> for planet <p>" mit HTTP 200.

planetstringPflicht
sunmoonmarsmercuryjupitervenussaturnrahuketu

Ein unbekannter Planet liefert den String "Invalid planet: <x>" mit HTTP 200, keinen Fehlerstatus. Beachte: Für rahu und ketu gibt es KEINE Nakshatra-Daten (insights['rahu']['nakshatras'] is None); get_planet_nakshatra_insight liefert daher "No nakshatra data available for rahu".

signstringPflicht
ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspisces

DATENFEHLER, den du kennen solltest: Bei planet='sun' ist der Schlüssel falsch als 'vigro' statt 'virgo' geschrieben. sun+virgo liefert daher "Invalid sign: virgo for planet sun", sun+vigro dagegen funktioniert. Alle acht anderen Planeten verwenden 'virgo'.

Verfügbare Keys (3)

Liste in keys genau die Berechnungen auf, die du brauchst. Ein unbekannter Key lässt die ganze Anfrage scheitern. Du zahlst 1 Credit, ganz gleich, wie viele du anforderst – fass sie also in einer Anfrage zusammen.

KeyZusätzliche FelderBeschreibung
get_planet_house_insightplanet, houseDie Deutung für `planet` in einem Haus; `house` ist 1 bis 12. Liefert ein Objekt mit der Bezeichnung des Hauses, einer Zusammenfassung und Listen von Eigenschaften, dazu `classicalTexts` – eine Liste von `{heading, text}` mit Zitaten aus Parashara, Brihat Jataka, Saravali und Phaladipika zu dieser Stellung – und `houseLordVariations`, eine Liste von `{ascendent, aspect, result}`, die zeigt, wie sich die Deutung für jeden der zwölf Aszendenten ändert. Wo nur die klassischen Zitate vorliegen, sind einige Felder für Zusammenfassung und Eigenschaften null.
get_planet_nakshatra_insightplanet, nakshatraDie Deutung für `planet` in `nakshatra`, als ein oder zwei Sätze einfacher Text statt als strukturiertes Objekt. Verfügbar für die sieben klassischen Planeten in allen 27 Nakshatras; für Rahu und Ketu gibt es keine Nakshatra-Deutungen, sie liefern stattdessen einen erklärenden String.
get_planet_sign_insightplanet, signDie Deutung für `planet` in `sign`. Liefert ein Objekt mit `sign` (der Sanskrit-Bezeichnung der Kombination, etwa "Mesa Brhaspati"), einem Absatz `summary` und den Listen `core traits`, `psychologicalPhysicalTraits`, `astrologicalReasoning` und `drstiphala`; die letzte beschreibt die Wirkung der Aspekte, die der Planet von dort aus wirft. Beachte das Leerzeichen im Feldnamen `core traits`.

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/planet_insights/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_planet_sign_insight"],"planet":"Jupiter","sign":"aries","house":0,"nakshatra":"rohini"}'

Antwort

{
  "data": {
    "get_planet_sign_insight": {
      "sign": "Mesa Brhaspati",
      "summary": "Jupiter in Aries produces a bold, authoritative, and resourceful individual with strong leadership capabilities. Aries is ruled by Mars (Maṅgala), a planet friendly to Jupiter and symbolizing courage, initiative, and battle-readiness. Jupiter here gains the spirit of a warrior-sage, combining spiritual strength with physical initiative. The placement enhances fame, wealth, power, and generational prosperity, especially through sons. However, the position also introduces difficulties like enemies, physical injuries, and excessive expenditures due to Aries being the debilitation sign for Saturn (Śani), whose tamasic qualities interfere with Jupiter's sattvic nature. The individual is splendorous, generous, and powerful, but also faces trials that temper their greatness",
      "core traits": [
        "Argumentative in disposition",
        "Acquiring precious stones and ornaments through effort",
        "Endowed with strength, sons, and wealth",
        "Eminent and famous profession",
        "Splendorous",
        "Many enemies",
        "Many expenses",
        "Injured body",
        "Confers severe and cruel punishments"
      ],
      "psychologicalPhysicalTraits": [
        "Argumentative in disposition",
        "Acquiring precious stones and ornaments through effort",
        "Endowed with strength, sons, and wealth",
        "Eminent and famous profession",
        "Splendorous",
        "Many enemies",
        "Many expenses",
        "Injured body",
        "Confers severe and cruel punishments",
        "Love of grandeur",
        "Powerful",
        "Wealthy",
        "Prudent",
        "Many children",
        "Courteous",
        "Generous",
        "Firm",
        "Sympathetic",
        "Happy marriage",
        "Patient nature",
        "Harmonious",
        "Refined",
        "High position"
      ],
      "astrologicalReasoning": [
        {
          "heading": "Initiative & Argumentation",
          "text": "Meṣa is ruled by Maṅgala, the god of war and action, endowing Jupiter with a strong fighting disposition and argumentative temperament."
        },
        {
          "heading": "Wealth & Luxuries",
          "text": "Sūrya, exalted in Meṣa, governs precious metals and gemstones. Jupiter, the Dhanakāraka, placed here results in acquiring valuables through effort."
        },
        {
          "heading": "Progeny & Strength",
          "text": "Meṣa is a masculine sign ruled by male planets (Sūrya and Maṅgala). Jupiter, as the Santana Kāraka, gains support here, indicating sons, strength, and vitality."
        },
        {
          "heading": "Fame & Eminence",
          "text": "As the 1st house of Kālapuruṣa, Aries governs fame. Jupiter's placement brings name, professional eminence, and public recognition."
        },
        {
          "heading": "Drawbacks of the Sign",
          "text": "Meṣa is Śani's debilitation sign. Jupiter here absorbs Śani's weaknesses, causing a rise in enemies (6H), injury-proneness, emotional detachment (due to 8H being Moon's debilitation), and heavy expenditure (12H effects)."
        },
        {
          "heading": "Judgement & Harshness",
          "text": "With Jupiter reflecting Maṅgala's and Śani's stern traits, the native may confer harsh or severe judgments lacking emotional nuance."
        }
      ],
      "drstiphala": [
        {
          "planet": "Sūrya",
          "aspect": "positive",
          "result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
        },
        {
          "planet": "Candra",
          "aspect": "positive",
          "result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
        },
        {
          "planet": "Maṅgala",
          "aspect": "positive",
          "result": "Belonging to a royal dynasty, fearless, fierce, endowed with political knowledge, modest, affluent, has a disobedient wife and disobedient servants."
        },
        {
          "planet": "Budha",
          "aspect": "negative",
          "result": "Liar, crafty, sinful, skilful in detecting others' flaws, serves others, grateful, modest, not outspoken."
        },
        {
          "planet": "Śukra",
          "aspect": "positive",
          "result": "Very happy with residences, sleeping comforts, robes, perfumes, garlands, ornaments, wife, very timid."
        },
        {
          "planet": "Śani",
          "aspect": "mixed",
          "result": "Talkative, eloquent, devoid of happiness, brilliant, has mean children and a mean wife."
        }
      ]
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data, jeweils unter dem Key, den du angefordert hast.

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.