API d’astrocartographie

Requête

Une requête réelle : le thème de démonstration face à Lisbonne.

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}}'

Réponse

Une partie de la réponse à cette requête : les champs principaux, avec chaque liste réduite à ses trois premiers éléments.

{
  "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"
}

Ce que contient la réponse

• relocated : l’Ascendant et le Milieu du Ciel du thème dans ce lieu.
• angularPlanets : les planètes sur ces angles, chacune avec son angle, son orbe et sa force.
• spheres : un score de 0 à 10 pour chaque sphère (identity, love, body, money, home, mind), 5 étant neutre ; overall10 en fait la synthèse.
• strength : forte quand une planète majeure se trouve à moins de 2° d’un angle, modérée à moins de 4°, faible sinon. Les règles accompagnent la réponse.
• POST /v1/locations/rank renvoie les meilleures villes du catalogue, selon les six sphères ou celles que vous choisissez, dans le monde entier ou dans une région.

Limites

• Réservé à API Pro. Avec la clé gratuite, les deux endpoints renvoient 403 avec un lien pour passer à la formule supérieure.
• Une heure de naissance est obligatoire : la relocalisation déplace les angles, et les angles dépendent de l’heure.
• Le classement compare 61 grandes villes, et non tous les lieux de la Terre ; tout autre lieu peut être noté avec POST /v1/locations/score.
• Les données de naissance sont lues, utilisées puis oubliées : les corps de requête ne sont jamais conservés.

Dans un assistant IA

Via le serveur MCP, à l’adresse https://www.natalchart.ai/mcp, les assistants appellent location_score pour un lieu et best_cities pour les meilleures villes.

Le reste de l’API

La même clé donne accès à toute l’API d’astrologie : thèmes astraux, transits du jour, synastrie, transits sur une période, révolutions solaires, meilleurs jours et astrocartographie. Tous les endpoints, champs et erreurs figurent dans la documentation, et la page des tarifs précise ce qui compte comme une requête.

Questions