API астрокартографії

Запит

Справжній запит: демонстраційна карта для Лісабона.

curl -X POST https://api.natalchart.ai/v1/locations/score \
  -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},"location":{"name":"Lisbon","latitude":38.7223,"longitude":-9.1393}}'

Відповідь

Частина відповіді на цей запит: основні поля, кожен список скорочено до перших трьох елементів.

{
  "relocated": {
    "ascendant": {
      "longitude": 277.7847,
      "sign": "Capricorn"
    },
    "midheaven": {
      "longitude": 210.708,
      "sign": "Scorpio"
    }
  },
  "angularPlanets": [
    {
      "planet": "Uranus",
      "angle": "ASC",
      "orb": 2.12,
      "weight": "major",
      "strength": "strong"
    },
    {
      "planet": "Neptune",
      "angle": "ASC",
      "orb": 6.31,
      "weight": "major",
      "strength": "weak"
    }
  ],
  "spheres": {
    "identity": {
      "score10": 1,
      "verdict": "challenging"
    },
    "love": {
      "score10": 6.1,
      "verdict": "slightly supportive"
    },
    "body": {
      "score10": 3.2,
      "verdict": "challenging"
    },
    "money": {
      "score10": 2.2,
      "verdict": "challenging"
    },
    "home": {
      "score10": 1.7,
      "verdict": "challenging"
    },
    "mind": {
      "score10": 4.9,
      "verdict": "neutral"
    }
  },
  "overall10": 2.2,
  "strength": "moderate"
}

Що повертається

• relocated: асцендент і середина неба, які карта має в цьому місці.
• angularPlanets: планети на цих кутах, кожна з кутом, орбісом і силою.
• spheres: Я, Любов, Тіло, Гроші, Дім і Розум, кожна від 0 до 10, де 5 це нейтрально; overall10 зводить їх в одне число.
• strength: сильна, коли одна з основних планет у межах 2° від кута, помірна в межах 4°, слабка в інших випадках. Правила надходять разом із відповіддю.
• POST /v1/locations/rank повертає найкращі міста з каталогу за всіма шістьма сферами або за обраними вами, по всьому світу або в одному регіоні.

Обмеження

• Лише API Pro. З безкоштовним ключем обидва ендпоінти відповідають кодом 403 і посиланням для переходу на API Pro.
• Потрібен час народження: релокація зсуває кути, а для кутів потрібен час.
• Рейтинг порівнює великі міста з каталогу (усього 61), а не всі місця на Землі; будь-яке інше місце можна оцінити через POST /v1/locations/score.
• Дані народження зчитуються, використовуються й забуваються: тіла запитів ніколи не зберігаються.

В AI-асистенті

Через MCP-сервер за адресою https://www.natalchart.ai/mcp асистенти викликають location_score для одного місця і best_cities для найкращих міст.

Інші можливості API

Той самий ключ відкриває весь астрологічний API: натальні карти, щоденні транзити, синастрію, транзити за період, соляри, найкращі дні й астрокартографію. Усі ендпоінти, поля й помилки описано в документації, а на сторінці цін пояснено, що вважається запитом.

Запитання