/api/astro/retrograde/1 créditPériodes rétrogrades
Toutes les périodes rétrogrades d’une année, dans une réponse compacte. Le mouvement rétrograde, ou vakri, est le recul apparent d’une planète par rapport aux étoiles, et la pratique astrologique traite ces périodes comme une phase à part dans le comportement de la planète. Envoyez `year` et rien d’autre. La réponse est `data.planets`, un objet indexé par nom de planète, dont chaque entrée contient une liste d’horodatages `{start, end}` en UTC. Les périodes à cheval sur deux années sont tronquées au 1er janvier et au 31 décembre : une plage qui commence à `01-01 00:00:00` a donc en réalité débuté l’année précédente. Une planète qui ne devient jamais rétrograde cette année-là a une liste vide. Dix clés sont renvoyées : mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu et ketu. Le Soleil et la Lune sont omis, car vus de la Terre ils ne sont jamais rétrogrades. Rahu et Ketu sont dérivés du nœud lunaire moyen, qui recule régulièrement toute l’année sans station : tous deux affichent donc toujours une seule plage couvrant l’année entière ; avec le nœud vrai, on obtiendrait des dizaines d’entrées parasites de quelques jours. Pour trouver les heures de station, on encadre le jour où la vitesse en longitude change de signe, puis on affine à l’intérieur de ce jour : la précision est donc nettement inférieure à la minute. Les mêmes valeurs figurent dans `/api/planetary_details/`, regroupées avec huit autres calculs ; cet endpoint ne renvoie que les données de rétrogradation.
https://api.occultapi.com/api/astro/retrograde/
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/jsonChamps de la requête
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| year | integer | obligatoire | Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres. min 1800 · max 2400 |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/retrograde/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026}'Réponse
{
"data": {
"year": 2026,
"planets": {
"mercury": [
{
"start": "2026-02-26 06:47:34",
"end": "2026-03-20 19:33:02"
},
{
"start": "2026-06-29 17:34:35",
"end": "2026-07-23 22:58:49"
},
{
"start": "2026-10-24 07:12:44",
"end": "2026-11-13 15:54:27"
}
],
"venus": [
{
"start": "2026-10-03 07:13:14",
"end": "2026-11-14 00:29:50"
}
],
"mars": [],
"jupiter": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-03-11 03:53:41"
},
{
"start": "2026-12-13 00:30:39",
"end": "2026-12-31 00:00:00"
}
],
"saturn": [
{
"start": "2026-07-26 18:57:26",
"end": "2026-12-11 00:30:23"
}
],
"uranus": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-02-04 02:56:33"
},
{
"start": "2026-09-10 18:24:34",
"end": "2026-12-31 00:00:00"
}
],
"neptune": [
{
"start": "2026-07-07 09:57:49",
"end": "2026-12-13 00:46:51"
}
],
"pluto": [
{
"start": "2026-05-06 12:13:55",
"end": "2026-10-16 05:33:46"
}
],
"rahu": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-12-31 00:00:00"
}
],
"ketu": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-12-31 00:00:00"
}
]
}
},
"message": "successful",
"is_error": false
}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.