NatalChart.AI API'si, NatalChart.AI uygulamasının geliştiricilere açılmış hesaplama motorudur. Doğum tarihini, saatini ve koordinatları gönderin, haritayı geri alın: barındırılacak efemeris dosyası, bakımı yapılacak saat dilimi tablosu, güncel tutulacak astroloji kütüphanesi yok.
Neler geliştirebilirsiniz
Doğum haritası sayfaları
Güneş, Ay ve yükselen burç, burcu ve eviyle her gezegen, orblarıyla açılar ve element dengesi; 1800 ile 2399 arasındaki her doğum için. /v1/chart/full, /v1/chart/short
Gerçek gökyüzünden günlük burç yorumları
Günün bir kişinin haritasına yaptığı transitler, her biri orbuyla ve güçlenmekte mi yoksa zayıflamakta mı olduğuyla birlikte; ayrıca Ay'ın evresi ve haftanın gökyüzü olayları. /v1/horoscope/daily, /v1/sky
Tanışma uygulamaları için uyum
İki haritanın karşılaştırması: aralarındaki her açı, her kişinin gezegenlerinin diğerinin hangi evlerine düştüğü ve her yaşam alanı için bir puan. /v1/synastry
Öngörüler ve önünüzdeki yıl
En fazla 92 günlük bir aralıktaki tam transitler (en önemlilerinden başlayarak en fazla 60 olay) ve herhangi bir yılın Güneş dönüşü haritası; doğum yeri için ya da kişinin o sırada bulunacağı yer için. /v1/transits, /v1/solar-return
En iyi günler
Bir aralığın her günü bir etkinlik (iş, aşk, seyahat, sağlık ve dahası) için puanlanır; lehte ve aleyhte olan transitlerle birlikte. /v1/timing
Astrokartografi ve relokasyon
Bir haritaya göre puanlanan tek bir şehir ya da o harita için sıralanan dünyanın büyük şehirleri; yaşam alanına ve bölgeye göre. /v1/locations/score, /v1/locations/rank
Bir dakikada başlayın
Uygulamanın Ayarlar bölümündeki API & MCP sekmesinde bir anahtar oluşturun (ücretsiz, kart gerekmez), ardından bir doğum verisi gönderin:
curl https://api.natalchart.ai/v1/chart/short \
-H "Authorization: Bearer $NATALCHART_API_KEY" \
-H "Content-Type: application/json" \
-d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234}}'Tüm uç noktalar, alanlar ve hatalar API belgelerinde yer alır; kod üreticileri için bunları OpenAPI belgesi tanımlar.
Kontrol edebileceğiniz doğruluk
Tropikal zodyak, Placidus ev sistemi, beş majör açı, gerçek Ay düğümü, derecenin dört ondalık basamağına kadar konumlar. Saat dilimi, doğum tarihindeki yaz saati kurallarıyla koordinatlardan belirlenir; doğum saati bilinmiyorsa konumlar varsayılan yerel saat 12:00 için hesaplanır, evler ve köşe noktaları ise tahmin edilmek yerine dışarıda bırakılır. Doğruluk raporu motoru yayımlanmış tek bir test haritası üzerinde NASA JPL Horizons ile karşılaştırır; yayımlanan örnek harita ise herhangi bir kod yazmadan önce bir yanıtı kontrol etmenizi sağlar.
Yapay zekâ asistanları için: MCP sunucusu
Aynı hesaplamalar https://www.natalchart.ai/mcp adresinde bir MCP sunucusu olarak sunulur. Claude, ChatGPT, Cursor ve VS Code aynı anahtarla bağlanır ve harita, transit ve uyum araçlarını kendileri çağırır; böylece asistan tahmin edilmiş değil, hesaplanmış bir haritayı okur.
Fiyatlar
| Plan | Fiyat | İstekler | Uç noktalar |
|---|---|---|---|
| Ücretsiz | $0 | Günde 10 | Haritalar ve bölümleri, günlük burç yorumu, gökyüzü, kullanım |
| Premium | Aylık $9.99 ya da yıllık $79 | Günde 100 | Her şey: transitler, sinastri, Güneş dönüşleri, en iyi günler, konumlar |
| MAX | Aylık $19.99 ya da yıllık $179 | Günlük sınır yok | Her şey: transitler, sinastri, Güneş dönüşleri, en iyi günler, konumlar |
Premium ve MAX, NatalChart.AI uygulamasının planlarıdır: tek abonelik uygulamayı, API'yi ve MCP sunucusunu kapsar. Havuz hesap başınadır, hesabın tüm anahtarları tarafından paylaşılır ve 00:00 UTC'de yenilenir. Geçersiz olduğu için reddedilen bir istek sayılmaz, bizim tarafımızda başarısız olan bir istek havuza geri eklenir ve doğum verileri asla saklanmaz: kayıtta yalnızca uç nokta, durum ve süre tutulur.
Diğer API'lerle karşılaştırma
Yedi astroloji API'si yan yana: veriler her sağlayıcının kendi fiyatlandırma sayfasından alınmış ve 16 Ekim 2026 tarihinde kontrol edilmiştir. Fiyatlar değişir, bu yüzden karar vermeden önce bağlantılara göz atın.
| API | Ücretsiz plan | En ucuz plan | Çağrılar nasıl sayılır | MCP sunucusu |
|---|---|---|---|---|
| NatalChart.AI | Temel uç noktalarda günde 10 istek, kart gerekmez | Premium: günde 100 istek için aylık $9.99 (ayda yaklaşık 3.000). MAX: aylık $19.99, günlük sınır yok. İkisinde de tüm uç noktalar, uygulama ve MCP sunucusu var. | Uç nokta ne olursa olsun çağrı başına bir istek | Evet, 10 araç, ücretsiz anahtarla da |
| AstrologyAPI.com | Test çağrıları, kart gerekmez | Ayda 50.000 istek için aylık $49 (Batı astrolojisi doğum haritası verileri ve harita çarkı); sinastri $99'dan başlayan fiyatlarla | Plana göre istekler ya da kredi cüzdanı | Evet |
| Astrology-API.io | Ayda 50 istek | Ayda 1.000 istek için aylık $11 | Çağrı başına bir kredi; birkaç uç nokta daha pahalı | Evet |
| FreeAstroAPI | Günde 80 istek, kart gerekmez | Ayda 50.000 istek için aylık $8 | Çağrı başına bir istek | Evet |
| Prokerala | Ayda 5.000 kredi | 100.000 kredi için aylık $19 | Uç noktaya göre değişen kredi (Batı astrolojisinde bir doğum haritası 500 kredi) | Resmî sunucu yok |
| RoxyAPI | Yok (kayıt gerektirmeyen bir deneme ortamı var) | Ayda 50.000 istek için aylık $39 | Çağrı başına bir istek | Evet |
| AstroWay | Ayda 10.000 kredi | 50.000 kredi için aylık $5 | Uç noktaya göre değişen kredi | Evet |
Bu API'nin yapmadıkları: başka zodyaklar ya da ev sistemleri, harita görselleri, PDF raporları, Vedik astroloji, yazılı yorumlar. Yukarıdaki API'lerden birkaçı bunları sunar. Yaptıkları: her hesaplama için sabit tek bir istek, tek bir test haritasını NASA JPL Horizons ile karşılaştıran bir doğruluk raporu ve asla saklanmayan doğum verileri.
Sorular
Ücretsiz bir astroloji API'si var mı?
Evet. NatalChart.AI anahtarı ücretsizdir ve günde 10 istek hakkı verir: tam ya da bölüm bölüm doğum haritaları, bir haritaya yapılan transitlerle birlikte günlük gökyüzü ve herhangi bir tarih için gezegen konumları. Kart gerekmez. Premium (aylık $9.99) havuzu günde 100 isteğe çıkarır ve bir dönemin transitlerini, sinastriyi, Güneş dönüşlerini, en iyi günleri ve astrokartografiyi açar; MAX (aylık $19.99) planında ise günlük sınır yoktur. İkisi de NatalChart.AI uygulamasının planlarıdır, yani tek abonelik uygulamayı, API'yi ve MCP sunucusunu kapsar.
Hesaplamalar ne kadar doğru?
Konumlar, profesyonel astroloji yazılımlarının standardı olan Swiss Ephemeris ile, veri dosyaları kullanılarak ve hız bayrağı açık olarak hesaplanır. NatalChart.AI uygulamasındaki her haritayı aynı motor çizer ve doğruluk raporu bu motorun yayımlanmış tek bir test haritası için verdiği çıktıyı NASA JPL Horizons ile karşılaştırır.
Bunun üzerine bir burç yorumu ya da uyum uygulaması geliştirebilir miyim?
Evet, amacı da bu: doğum haritası sayfaları, gerçek transitlere dayalı günlük burç yorumları, tanışma uygulamaları için uyum puanları, en iyi gün seçicileri ve relokasyon haritaları. Ticari kullanıma her planda izin verilir; anahtarı kendi sunucunuzda tutun.
Yazılı yorumlar döndürüyor mu?
Hayır. API hesaplar ve sayılar döndürür: burçlar, dereceler, evler, orblarıyla açılar, yaşam alanı başına puanlar. Yapay zekâ çağrısı yoktur, bu yüzden aynı girdi her zaman aynı çıktıyı verir; sözcükler ise size ya da modelinize kalır.
Hangi programlama dilleri ve framework'lerle çalışır?
JSON gövdeli bir HTTPS isteği gönderebilen her şeyle: JavaScript, Python, PHP, Swift, Kotlin, kodsuz araçlar. Belgelerde kopyalayıp yapıştırabileceğiniz örnekler vardır ve bir OpenAPI belgesi, kod üreticileri için her uç noktayı tanımlar.
Yapay zekâ asistanları bunu kullanabilir mi?
Evet, MCP sunucusu üzerinden: Claude, ChatGPT, Cursor ve VS Code ona aynı anahtarla bağlanır ve hesaplamaları araç olarak çağırır.