Démarrage rapide
Envoyez une vraie requête, lisez une vraie réponse, puis branchez-la dans votre code. Un appel en échec ne coûte rien.
1. Obtenez une clé
Créez un compte et générez une clé depuis la page des clés. Chaque nouveau compte reçoit 150 crédits gratuits, utilisables sur la vraie API avec une clé de production — pas dans un bac à sable avec ses propres données.
La clé ne s’affiche qu’une fois et nous n’en conservons qu’une empreinte (hash) : impossible de la récupérer pour vous. Rangez-la tout de suite dans votre gestionnaire de secrets. Si vous la perdez, renouvelez-la plutôt que de contacter le support.
2. Essayez dans le Playground
Ouvrez le Playground, collez votre clé, choisissez un endpoint et envoyez. Il exécute de vrais appels sur l’API en production avec votre propre clé ; un appel en échec ne coûte rien. Faites-le avant d’écrire la moindre ligne : en quelques secondes, vous saurez si la réponse contient ce dont votre produit a besoin.
3. Lancez l’appel
Tout passe par un POST avec un corps JSON, authentifié par l’en-tête X-API-Key. Cette requête demande le panchang du jour à Jaipur :
curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"date_time": "2026-09-16T06:00:00+05:30",
"latitude": 26.9124,
"longitude": 75.7873,
"timezone_as_float": 5.5,
"keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"]
}'const response = await fetch(
"https://api.occultapi.com/api/astro/panchanga/",
{
method: "POST",
headers: {
"X-API-Key": process.env.OCCULT_API_KEY!,
"Content-Type": "application/json",
},
body: JSON.stringify({
date_time: "2026-09-16T06:00:00+05:30",
latitude: 26.9124,
longitude: 75.7873,
timezone_as_float: 5.5,
keys: ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"],
}),
},
);
const body = await response.json();
if (body.is_error) throw new Error(body.message);
console.log(body.data);import os, requests
response = requests.post(
"https://api.occultapi.com/api/astro/panchanga/",
headers={"X-API-Key": os.environ["OCCULT_API_KEY"]},
json={
"date_time": "2026-09-16T06:00:00+05:30",
"latitude": 26.9124,
"longitude": 75.7873,
"timezone_as_float": 5.5,
"keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"],
},
)
body = response.json()
if body["is_error"]:
raise RuntimeError(body["message"])
print(body["data"])4. Lisez la réponse
Toutes les réponses utilisent la même enveloppe. Testez is_error ; le résultat se trouve dans data, sous le nom de chaque clé demandée.
{
"data": {
"tithi": {
"paksha": "Shukla",
"name": "Panchami",
"number": 5,
"start_time": "2026-09-15T02:15:17Z",
"end_time": "2026-09-16T03:30:28Z",
"remaining_time": { "hours": 3, "minutes": 0, "seconds": 28 }
},
"nakshatra_segments": [
{ "name": "Vishakha", "start_time": "2026-09-15T09:51:13.999999Z", "end_time": "2026-09-16T11:52:46.999999Z" },
{ "name": "Anuradha", "start_time": "2026-09-16T11:52:46.999999Z", "end_time": "2026-09-17T14:23:53.999999Z" }
],
"yogam": "Vaidhriti",
"karana": "Balava",
"vaara": "Mangalavara"
},
"status": 200,
"is_error": false,
"message": "successful"
}La structure des champs varie selon l’endpoint. La plupart des pages de la référence montrent une vraie réponse capturée, pas une réponse inventée ; les quelques pages pas encore vérifiées le signalent.
5. Vérifiez le coût
Les en-têtes de la réponse vous l’indiquent, sans second appel :
X-Credits-Cost: 1
X-Credits-Charged: 1 # 0 on any error — you are billed for answers
X-Credits-Remaining: 149Demandez plusieurs keys dans une même requête plutôt que de multiplier les requêtes. Le prix est le même dans les deux cas : un appel pour cinq calculs coûte cinq fois moins que cinq appels.
Pas envie d’écrire la plomberie ?
Branchez un assistant IA sur notre serveur MCP : il peut chercher les endpoints, lire un schéma de requête et faire l’appel lui-même. Chercher et lire la documentation ne coûte aucun crédit. Si vous travaillez avec un agent de code, donnez-lui d’abord /agents. Pour générer un client typé dans n’importe quel langage, utilisez la spécification OpenAPI.