Direkt zum Inhalt
POST/api/astro/chat/25 Credits

Astrologie-Chat

Stelle eine Frage zu einem Geburtshoroskop und erhalte eine verständliche Antwort, die sich auf die klassischen Texte stützt. Zu jeder Antwort gehören die Textstellen, auf die sie sich beruft – jeweils mit Quelle und Relevanzwert –, damit sich die Begründung prüfen lässt, statt dass man ihr einfach glauben muss. Für Fragen zur Kompatibilität übergibst du in `compare_with` eine zweite Person. Dieser Endpoint ist ZUSTANDSLOS. Zwischen den Aufrufen wird nichts gespeichert, und es ist kein Konto nötig: Die Geburtsdaten kommen aus deiner Anfrage, du kannst also für jeden deiner eigenen Nutzer fragen. Um ein Gespräch fortzusetzen, speichere den Verlauf in deiner Anwendung und übergib ihn in `history` – bis zu zwanzig frühere Runden. Ein Aufruf kostet 25 Credits statt der üblichen 1, weil für jede Antwort ein Sprachmodell das berechnete Horoskop auswertet. Eine fehlgeschlagene oder leere Antwort kostet nichts, wie bei allen anderen Endpoints hier.

https://api.occultapi.com/api/astro/chat/
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
birthobjectPflicht

Um wessen Horoskop es in der Frage geht.

questionstringPflicht

Die Frage zum Horoskop.

compare_withobjectoptional

Eine zweite Person für Fragen zur Kompatibilität. Optional.

historyarrayoptional

Frühere Runden, die älteste zuerst, höchstens 20. Dieser Endpoint speichert zwischen den Aufrufen nichts; übergib also allen Kontext, den die Antwort berücksichtigen soll.

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/chat/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"Which planet rules my ascendant, and what does it say about my career?","birth":{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"place":"Jaipur, India","name":"Asha","gender":"female"}}'

Antwort

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"answer\": \"Asha, your ascendant or rising sign is Leo, which is ruled by the Sun. \\n\\nWith the Sun as the ruler of your ascendant (Leo), it highlights qualities such as leadership, confidence, and a desire to be in the spotlight. This influence often urges you to pursue a career where you can shine or be in a position of authority. Roles that allow you to take charge, make decisions, and impact others positively are likely appealing to you. \\n\\nGiven the Sun's influence on your career house (the 10th house), roles in management, administration, public relations, or any profession that allows you to showcase your talents and earn recognition might be particularly fulfilling for you.\", \"question\": \"Which planet rules my ascendant, and what does it say about my career?\", \"sources\": [{\"source\": \"Planets in Signs and Houses.txt\", \"snippet\": \"Pluto in the Ninth House: Can't stand religious hypocrisy, can you? Can anybody? Well, nobody\\r\\nLIKES...\", \"score\": 0.021327968686819077}, {\"source\": \"54418030-PRASHNA-by-Gayatri-D-Vasudev.txt\", \"snippet\": \"Ascendant or the Ascendant lord, or if the Ascen-\\r\\ndant and 11th lords are favourably disposed,\\r\\npre...\", \"score\": 0.018708257004618645}, {\"source\": \"Graha_Yuddha.txt\", \"snippet\": \"the Ascendant lord is\\r\\ninvolved. Mars as loser brings exceptional results. Graha Yuddha is not consi...\", \"score\": 0.01666666753590107}, {\"source\": \"kalyana-varma-saravali.txt\", \"snippet\": \"the 10th from the Moon, or\\r\\nfrom the Ascendant; whichever is stronger will prevail. The earnings (li...\", \"score\": 0.01666666753590107}, {\"source\": \"Book. Key to Learn - K.P. cuspal system - S.P. Khullar.txt\", \"snippet\": \"but the Blind Test results ignited\\r\\nmy interest sufficient for me to get fully involved in the syste...\", \"score\": 0.016393441706895828}, {\"source\": \"Planets and Children KN Rao.txt\", \"snippet\": \"that old Brahmin I have talked of, with a sense of gratitude,1\\r\\n\\\"No child in this world is born unle...\", \"score\": 0.016129031777381897}, {\"source\": \"Applications of Cuspal Interlinks Part 1 Baskaran.txt\", \"snippet\": \"of natal\\r\\nnature of the Asc leads the stage. But, in the\\r\\nperiods of Dasas and Bhukthies, that are\\r\\n...\", \"score\": 0.016129031777381897}, {\"source\": \"Kalamsa and Cuspal Interlinks _Khullar.txt\", \"snippet\": \"in Anuradha Nakshatra ruled by Saturn, it makes\\r\\nthe native cautious, calculative and pragmatic.\\r\\nEd...\", \"score\": 0.01612432301044464}, {\"source\": \"Kalamsa and Cuspal Interlinks _Khullar.txt\", \"snippet\": \"Ascendant is simultaneously linked to cusps 5 & 9 through its Star\\r\\nlord, it indicates a very poor p...\", \"score\": 0.01587301678955555}, {\"source\": \"Prashna Deepika English.txt\", \"snippet\": \"11. Defective speech and Stammering ?\\r\\n12. Can I learn music ?\\r\\n13. Am I to Commit Suicide ?\\r\\n14. Wh...\", \"score\": 0.01587301678955555}, {\"source\": \"Book. Key to Learn - K.P. cuspal system - S.P. Khullar.txt\", \"snippet\": \"effort that must have gone in preparing these lessons and the way\\r\\nthey have been presented by Mr. K...\", \"score\": 0.015625}, {\"source\": \"Kalyana Varmas Saravali.txt\", \"snippet\": \"be the aspecting planet with reference to the Ascendant one will be interested in\\r\\nreligious observa...\", \"score\": 0.015625}, {\"source\": \"Practical Horary Astrology Gayathri Vasudev.txt\", \"snippet\": \"or the house to which the question refers.\\r\\n\\r\\nSuppose the question is 'Will I succeed in a\\r\\nparticul...\", \"score\": 0.01547067891806364}, {\"source\": \"Kalamsa and Cuspal Interlinks _Khullar.txt\", \"snippet\": \"The\\r\\npotential of the Ascendant fixes the ultimate limit to which a\\r\\nperson can rise in any walk ofl...\", \"score\": 0.015384615398943424}, {\"source\": \"Predicting through Karakamsha and Jaimini_s Mandook Dasha.txt\", \"snippet\": \"was almost no hope of\\r\\nmy surviving.\\r\\n7. My schooling started, after coaching at home, at the age of...\", \"score\": 0.015384615398943424}, {\"source\": \"Kalamsa and Cuspal Interlinks _Khullar.txt\", \"snippet\": \"is symbolic of drive,\\r\\ndetenll"
}

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.