POST/api/astro/pdf/horoscope/25 Credits

Horoskop als PDF-Bericht

Ein vollständiges vedisches Horoskop als fertiges PDF, mit einem Aufruf. Der Antwort-Body IST das PDF (`application/pdf`) – keine zweite Anfrage, keine gehostete Datei. Über vierzig Seiten: Geburtsdaten und Panchang, Planetenpositionen mit Nakshatra-Herrschern, das Lagna-Horoskop im nord- und im südindischen Stil, das Mondhoroskop, zwölf Teilhoroskope, Häuserspitzen, Planetenfreundschaften, KP-Platzierungen, Sarvashtakavarga und eine Seite Bhinnashtakavarga für jeden Graha, drei Dasha-Systeme, bei denen die laufende Periode in Unterperioden aufgeschlüsselt ist, Befunde zu Kala Sarpa und Manglik, die vollständige Sade-Sati-Zeitleiste mit den Phasen Ardha Kantaka und Ashtama Shani, Numerologie, Empfehlungen zu Edelsteinen, Rudraksha und Mantras sowie eine Deutung für jeden der neun Grahas. WIR SPEICHERN NICHTS. Bericht-APIs legen die Datei meist in einem Bucket ab und geben einen Link zurück. Ein Geburtshoroskop – Name, Geburtszeit, Prognosen – liegt dann unter einer öffentlichen URL, solange das Objekt existiert. Hier kommen die Bytes direkt zu dir zurück. Auf unserer Seite wird nichts gespeichert, und es gibt keinen Link, den jemand anders finden könnte. Wenn du eine gehostete Kopie brauchst, speichere die Bytes selbst – mit deinem eigenen Ablaufdatum und deinen eigenen Zugriffsregeln. WHITE LABEL. Alles in `branding` ist optional und erscheint auf dem Deckblatt, in der Kopfzeile jeder Seite und in der Fußzeile – deine Kunden sehen also deinen Namen. Unserer taucht im Dokument nirgends auf. DER GEBURTSZEITPUNKT. Sende entweder `date_time` im Format ISO 8601 oder die einzelnen Felder `day`/`month`/`year`/`hour`/`minute` mit `timezone_as_float`. Sendest du beides, wird die Anfrage abgelehnt, statt stillschweigend eine Variante zu wählen: Wenn beide Angaben nicht übereinstimmen, lässt sich nicht sicher entscheiden, welche gilt, und das Ergebnis wäre ein Horoskop, das überzeugend aussieht, aber falsch ist. Jede Zahl wird von denselben Endpoints berechnet, die diese API anbietet – die Positionen auf Seite 3 sind genau das, was /api/astro/planet-positions/ liefert. Abschnitte scheitern unabhängig voneinander: Ist eine Berechnung für ein Horoskop nicht definiert, steht das auf der betreffenden Seite, und der restliche Bericht wird trotzdem erstellt. Der Antwort-Header `X-Report-Sections-Failed` gibt an, wie viele Abschnitte betroffen sind; so erkennst du einen vollständigen Bericht von einem lückenhaften, ohne ihn zu öffnen. Die typische Gesamtdauer liegt unter zwei Sekunden.

https://api.occultapi.com/api/astro/pdf/horoscope/

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
latitude	number (double)	Pflicht	Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen. min -90 · max 90
longitude	number (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
ayanamsa	string	optional
branding	object	optional	Reseller-Angaben, gedruckt auf Deckblatt, Kopfzeile und Fußzeile.
chart_style	string	optional	In welchem Stil das Geburtshoroskop gezeichnet wird. Standardmäßig sind beide enthalten. `northsouthboth`
date_time	string (date-time)	optional	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.
day	integer	optional	Tag des Monats als Zahl, 1-31. min 1 · max 31
gender	string	optional
hour	integer	optional	Geburtsstunde im 24-Stunden-Format, 0-23. Ortszeit am Geburtsort. min 0 · max 23
minute	integer	optional	min 0 · max 59
month	integer	optional	Geburtsmonat als Zahl, 1-12. Januar ist 1. min 1 · max 12
name	string	optional
place	string	optional
timezone_as_float	number (double)	optional	UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset. min -12 · max 14
year	integer	optional	Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern. min 1800 · max 2200

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/pdf/horoscope/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ajeet Kanojia","gender":"male","date_time":"1985-02-23T05:45:00+05:30","latitude":20.8833,"longitude":76.2,"timezone_as_float":5.5,"place":"Malkapur, Maharashtra, India","chart_style":"both","branding":{"company_name":"Acme Astrology","company_info":"Vedic reports since 2011.","company_email":"hello@acme.example","company_mobile":"+91 90000 00000","domain_url":"https://acme.example","footer_link":"acme.example"}}'

Antwort

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.