POST/api/astro/planet-positions/1 crédit

Positions planétaires

Positions sidérales des neuf grahas pour un moment et un lieu : longitude, signe, nakshatra, pada et maison pour chacun, ainsi que l’ascendant et l’ayanamsa réellement appliqué. Les planètes sont renvoyées sous forme de LISTE dans l’ordre traditionnel, avec `name` sur chaque entrée, au lieu d’être imbriquées sous un nom de thème et indexées par planète : vous pouvez donc les parcourir ou les afficher directement dans un tableau. Cet endpoint dérive de /api/astro/chart/, qui exige chart_name, notation, ayanamsa et ascendant_pos à chaque appel. Ici, ces champs valent par défaut RashiChart, degree, LAHIRI et cusp - envoyez simplement une date et un lieu. Choisissez tout de même `ayanamsa` en connaissance de cause : il décale toutes les longitudes de la réponse, et Lahiri et Raman diffèrent d’environ un degré, assez pour faire passer une planète dans un autre nakshatra. Les 48 ayanamsas pris en charge par l’endpoint du thème sont tous acceptés ici.

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

Tester la requête

Données de Positions planétaires affichées dans une interface — Les données de cet endpoint, affichées dans une vraie interface. L’API fournit les valeurs ; la mise en page, c’est à vous de la construire.

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

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

Champs de la requête

Champ	Type	Obligatoire	Remarques
chart_name	string	obligatoire
datetime	string (date-time)	obligatoire	Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC. Même signification que date_time, que d’autres endpoints désignent sous un autre nom.
latitude	number (double)	obligatoire	Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -89.9 · max 89.9
longitude	number (double)	obligatoire	Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180
aberration	boolean	facultatif
apply_correction	boolean	facultatif
ascendant_pos	string	facultatif	`cuspstartend`
ayanamsa	string	facultatif
background_color	string	facultatif	Couleur hexadécimale de l’arrière-plan SVG.
chart_style	string	facultatif	Style de diagramme lorsque render='svg'. 'north' est la disposition en losange, avec maisons fixes et signes tournants ; 'south' est la grille à signes fixes, avec maisons tournantes. `northsouth`
correction_deg	integer	facultatif	min 0
correction_direction	string	facultatif	`addsubtract`
correction_min	integer	facultatif	min 0 · max 59
correction_sec	integer	facultatif	min 0 · max 59
extended_bodies	array	facultatif	Groupes de corps à inclure : 'asteroids', 'planetary_moons', 'fictitious_bodies'.
label_style	string	facultatif	Manière de libeller les planètes : 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) ou 'symbol' (☉, ☽, ...). `englishsanskritsymbol`
line_color	string	facultatif	Couleur hexadécimale des lignes de la grille du thème.
notation	string	facultatif	`astrologicaldegree`
nutation	boolean	facultatif
planet_color	string	facultatif	Couleur hexadécimale des libellés des planètes, p. ex. '#111827'. Par défaut : la couleur propre au thème visuel.
rahu	string	facultatif	Type de nœud à inclure. 'true' ne renvoie que les nœuds vrais, 'mean' que les nœuds moyens, 'both' renvoie les deux. `truemeanboth`
refraction	boolean	facultatif
render	string	facultatif	Mettre à 'svg' pour renvoyer aussi un diagramme du thème rendu (voir chart_style) et la géométrie qui le sous-tend. Si vous l’omettez entièrement, la réponse reste inchangée. `nonesvg`
show_degrees	boolean	facultatif	Afficher, à côté du libellé de chaque corps, son degré dans le signe.
sign_color	string	facultatif	Couleur hexadécimale des numéros et abréviations des signes.
svg_size	integer	facultatif	Largeur et hauteur du viewBox SVG carré, en pixels. min 100 · max 2000
theme	string	facultatif	`lightdark`
true_mean	string	facultatif	`TrueMean`
use_28_nakshatras	boolean	facultatif

Exemple de requête

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

Réponse

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

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.