POST/api/astro/planet-positions/1 kredi

Gezegen konumları

Belirli bir an ve yer için dokuz grahanın sideral konumları: her biri için boylam, burç, nakshatra, pada ve ev; ayrıca yükselen ve gerçekte uygulanan ayanamsa. Gezegenler bir harita adının altında, gezegen adlarıyla anahtarlanmış iç içe bir yapıda değil, geleneksel sırayla ve her öğede `name` bulunan bir LİSTE olarak döner; böylece listeyi doğrudan dolaşabilir ya da tablo olarak gösterebilirsiniz. /api/astro/chart/ endpoint'inden türetilmiştir; o endpoint her çağrıda chart_name, notation, ayanamsa ve ascendant_pos ister. Burada bunların varsayılanları RashiChart, degree, LAHIRI ve cusp'tır - yalnızca bir tarih ve bir yer göndermeniz yeterlidir. Yine de `ayanamsa` değerini bilinçli olarak seçmeye değer: yanıttaki her boylamı kaydırır; Lahiri ile Raman arasında yaklaşık bir derece fark vardır ve bu, bir gezegeni başka bir nakshatraya geçirmeye yeter. Harita endpoint'inin desteklediği 48 ayanamsanın tümü burada da kabul edilir.

https://api.occultapi.com/api/astro/planet-positions/

İsteği deneyin

Gezegen konumları çıktısı bir arayüzde — Bu endpoint'in verileri, canlı bir arayüzde. Değerleri API verir; ekran düzenini siz kurarsınız.

Kimlik doğrulama

Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.

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

İstek alanları

Alan	Tür	Zorunlu	Notlar
chart_name	string	zorunlu
datetime	string (date-time)	zorunlu	Hesaplamanın yapılacağı an, ISO 8601 biçiminde. Değere HER ZAMAN bir saat farkı ya da sonda Z ekleyin - saat dilimi içermeyen bir değer UTC değil, Asia/Kolkata (UTC+05:30) olarak okunur. date_time ile aynı anlama gelir; diğer endpoint'ler aynı alanı farklı bir adla kullanır.
latitude	number (double)	zorunlu	Yerin enlemi, ondalık derece cinsinden. Pozitif değer kuzeyi, negatif değer güneyi gösterir. Örnek: Jaipur için 26.9124, New York için 40.7128. Dakika ve saniye kabul edilmez - önce ondalık dereceye çevirin. min -89.9 · max 89.9
longitude	number (double)	zorunlu	Yerin boylamı, ondalık derece cinsinden. Pozitif değer doğuyu, negatif değer batıyı gösterir. Örnek: Jaipur için 75.7873, New York için -74.0060. İşarete dikkat edin: eksi işaretini unutursanız New York Çin'e düşer. min -180 · max 180
aberration	boolean	isteğe bağlı
apply_correction	boolean	isteğe bağlı
ascendant_pos	string	isteğe bağlı	`cuspstartend`
ayanamsa	string	isteğe bağlı
background_color	string	isteğe bağlı	SVG arka planının hex rengi.
chart_style	string	isteğe bağlı	render='svg' olduğunda kullanılacak diyagram stili. 'north', evlerin sabit kalıp burçların döndüğü baklava düzenidir; 'south' ise burçların sabit kalıp evlerin döndüğü ızgara düzenidir. `northsouth`
correction_deg	integer	isteğe bağlı	min 0
correction_direction	string	isteğe bağlı	`addsubtract`
correction_min	integer	isteğe bağlı	min 0 · max 59
correction_sec	integer	isteğe bağlı	min 0 · max 59
extended_bodies	array	isteğe bağlı	Dahil edilecek cisim grupları: 'asteroids', 'planetary_moons', 'fictitious_bodies'.
label_style	string	isteğe bağlı	Gezegen etiketlerinin biçimi: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) veya 'symbol' (☉, ☽, ...). `englishsanskritsymbol`
line_color	string	isteğe bağlı	Harita ızgara çizgilerinin hex rengi.
notation	string	isteğe bağlı	`astrologicaldegree`
nutation	boolean	isteğe bağlı
planet_color	string	isteğe bağlı	Gezegen etiketlerinin hex rengi, ör. '#111827'. Varsayılan: temanın kendi rengi.
rahu	string	isteğe bağlı	Dahil edilecek düğüm türü. 'true' yalnızca gerçek düğümleri, 'mean' yalnızca ortalama düğümleri, 'both' ikisini birden döndürür. `truemeanboth`
refraction	boolean	isteğe bağlı
render	string	isteğe bağlı	Çizilmiş harita diyagramını (bkz. chart_style) ve onun geometrisini de almak için 'svg' olarak ayarlayın. Bu alanı hiç göndermezseniz yanıt değişmez. `nonesvg`
show_degrees	boolean	isteğe bağlı	Her cismin burç içindeki derecesini etiketinin yanında gösterir.
sign_color	string	isteğe bağlı	Burç numaralarının/kısaltmalarının hex rengi.
svg_size	integer	isteğe bağlı	Kare SVG viewBox alanının piksel cinsinden genişliği ve yüksekliği. min 100 · max 2000
theme	string	isteğe bağlı	`lightdark`
true_mean	string	isteğe bağlı	`TrueMean`
use_28_nakshatras	boolean	isteğe bağlı

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/planet-positions/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'

Yanıt

{
  "data": {
    "planets": [
      {
        "name": "sun",
        "longitude": 134.381,
        "latitude": 0,
        "nakshatra": "Poorva Phalguni",
        "pada": 1,
        "kakshya": "sun",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "moon",
        "longitude": 1.478,
        "latitude": 4.37,
        "nakshatra": "Ashwini",
        "pada": 1,
        "kakshya": "saturn",
        "zodiac_name": "Aries",
        "house": 9
      },
      {
        "name": "mars",
        "longitude": 79.175,
        "latitude": 0.535,
        "nakshatra": "Aardra",
        "pada": 4,
        "kakshya": "Mercury",
        "zodiac_name": "Gemini",
        "house": 11
      },
      {
        "name": "mercury",
        "longitude": 138.508,
        "latitude": 1.574,
        "nakshatra": "Poorva Phalguni",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "jupiter",
        "longitude": 109.472,
        "latitude": 0.529,
        "nakshatra": "Aasresha",
        "pada": 1,
        "kakshya": "Mercury",
        "zodiac_name": "Cancer",
        "house": 12
      },
      {
        "name": "venus",
        "longitude": 178.956,
        "latitude": -3.391,
        "nakshatra": "Chitra",
        "pada": 2,
        "kakshya": "ascendant",
        "zodiac_name": "Virgo",
        "house": 2
      },
      {
        "name": "saturn",
        "longitude": 349.447,
        "latitude": -2.651,
        "nakshatra": "Revati",
        "pada": 1,
        "kakshya": "Mercury",
        "zodiac_name": "Pisces",
        "house": 8
      },
      {
        "name": "northtruenode",
        "longitude": 305.566,
        "latitude": 0,
        "nakshatra": "Dhanishtha",
        "pada": 4,
        "kakshya": "jupiter",
        "zodiac_name": "Aquarius",
        "house": 7
      },
      {
        "name": "southtruenode",
        "longitude": 125.56599999999996,
        "latitude": 0,
        "nakshatra": "Makha",
        "pada": 2,
        "kakshya": "jupiter",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "uranus",
        "longitude": 41.424,
        "latitude": -0.154,
        "nakshatra": "Rohini",
        "pada": 1,
        "kakshya": "sun",
        "zodiac_name": "Taurus",
        "house": 10
      },
      {
        "name": "neptune",
        "longitude": 339.433,
        "latitude": -1.412,
        "nakshatra": "Uttaraabhaadra",
        "pada": 2,
        "kakshya": "mars",
        "zodiac_name": "Pisces",
        "house": 8
      },
      {
        "name": "pluto",
        "longitude": 279.279,
        "latitude": -4.3,
        "nakshatra": "Uttaraashaadha",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Capricorn",
        "house": 6
      }
    ],
    "ascendant": {
      "longitude": 132.1878846274937,
      "zodiac_name": "Leo",
      "nakshatra": "Makha",
      "pada": 4
    },
    "ayanamsa": {
      "name": "LAHIRI",
      "corrected": false,
      "value_degrees": 24.229599,
      "formatted": "24°13'47\""
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.

Hatalar

Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.