AstroSage API : construire une app ou un bot d'astrologie conversationnel

Si vous cherchez une AstroSage API, vous voulez probablement construire l'un de ces produits :

1. Une app de chat astrologique qui repond aux questions sur un theme.
2. Un bot WhatsApp, Telegram, Discord ou web.
3. Une plateforme complete avec theme vedique, dasha, Panchang, matching, horoscope et compatibilite.

FreeAstroAPI n'est pas affilie a AstroSage. Le point utile pour les developpeurs est architectural : nos endpoints vediques et astrologiques retournent des resultats structures de qualite production, avec une couverture adaptee a des experiences type AstroSage.

Il n'est donc pas necessaire de faire inventer les calculs au LLM. Utilisez l'API pour les donnees deterministes, puis laissez la couche IA expliquer ces donnees dans une voix conversationnelle.

Pourquoi une app type AstroSage a besoin de donnees structurees

Les produits de chat astrologique echouent quand le bot essaie de tout calculer depuis un prompt. Le modele peut sembler sur de lui tout en se trompant sur l'ascendant, le Moon Nakshatra, la Vimshottari dasha, le Panchang ou la compatibilite.

Un schema de production plus fiable :

1. Resoudre ville, fuseau horaire, latitude et longitude.
2. Appeler les endpoints de chart, dasha, Panchang, transit ou compatibilite.
3. Stocker la reponse structuree comme source de verite.
4. Demander au modele d'expliquer uniquement ce que l'API a retourne.
5. Conserver les references internes au payload exact utilise.

Vous obtenez une experience de conseiller astrologique intelligent, mais les calculs restent repetables.

Endpoints utiles pour une app type AstroSage

Utilisez POST /api/v2/vedic/calculate pour un payload d'onboarding compact. Utilisez les endpoints specialises quand un tour de chat demande une reponse ciblee, par exemple "Dans quelle dasha suis-je ?" ou "Est-ce un bon jour pour commencer ?".

Pipeline de chat MCP recommande

Si vous construisez une app comme agent IA, utilisez la couche MCP hebergee ou votre propre couche de tool calling au lieu de coller tous les endpoints dans le prompt.

Flux recommande :

1. Analyser la question et identifier le fait astrologique necessaire.
2. Verifier si le JSON necessaire est deja en cache.
3. Sinon, choisir le bon outil MCP ou endpoint API.
4. Appeler l'outil avec les donnees de naissance stockees.
5. Cacher le JSON brut avec endpoint, hash d'input, user id et timestamp.
6. Donner a l'IA la question et uniquement le JSON pertinent.
7. Demander la reponse finale depuis ce JSON, sans inventer de faits manquants.

En pratique, la premiere passe IA route la demande et ne repond pas encore :

{
  "intent": "current_dasha_question",
  "needs_tool": true,
  "tool": "vedic_dasha",
  "cache_key": "user_123:vedic_dasha:2026-04-24:lahiri",
  "reason": "The user asked which dasha is active today."
}

Le backend execute ensuite l'appel, stocke le JSON et lance une deuxieme passe IA :

User question:
{question}

Tool JSON:
{cached_or_fresh_json}

Instruction:
Answer only from the Tool JSON. If the JSON does not contain the requested fact, say what additional tool or birth detail is needed.

Cette architecture est plus fiable que demander au modele de decider, calculer et expliquer en une seule passe.

Strategie de cache

Cachez par utilisateur, endpoint, input normalise et date ou plage de dates.

Stockez toujours le JSON brut complet. Vous pouvez aussi stocker un objet "facts" plus petit pour la recherche, mais gardez la reponse originale pour debugger et auditer les reponses.

Gestion des follow-ups

Les messages suivants doivent reutiliser le contexte avant d'appeler un nouvel outil.

Separez bien memoire de conversation, faits astrologiques caches et nouveaux appels d'outils.

Endpoints publics combinables

Endpoints Vedic astrology

Endpoints Western astrology

Endpoints chart rendering et visual

Endpoints astrocartography

Endpoints horoscope et signes simples

Endpoints Chinese astrology

Endpoints utility et platform

Construire le chat pas a pas

1. Collecter les donnees de naissance

Votre onboarding doit demander :

• Name
• Date of birth
• Time of birth
• Birth city
• Latitude and longitude when available
• Timezone, or AUTO

Les coordonnees sont preferables aux noms de villes, car plusieurs villes portent le meme nom.

curl -G "https://api.freeastroapi.com/api/v2/geo/search" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "q=Mumbai" \
  --data-urlencode "country=IN" \
  --data-urlencode "limit=5"

2. Creer le profil vedique de base

Appelez l'endpoint complet apres onboarding et stockez la reponse comme profil astrologique.

curl -X POST "https://api.freeastroapi.com/api/v2/vedic/calculate" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "year": 1994,
    "month": 8,
    "day": 11,
    "hour": 6,
    "minute": 42,
    "city": "Mumbai",
    "lat": 19.0760,
    "lng": 72.8777,
    "tz_str": "AUTO",
    "ayanamsha": "lahiri",
    "vargas": [1, 9, 10],
    "include_yogas": true,
    "include_panchang": true,
    "include_shadbala": true,
    "include_ashtakavarga": true,
    "dasha_levels": 3
  }'

Ce payload couvre les questions courantes : Lagna, Moon Nakshatra, dasha active, yogas de carriere, D9 et mariage.

3. Router chaque question

Ne lancez pas tous les endpoints a chaque message. Classez d'abord l'intention.

4. Donner les faits au LLM

You are an astrology assistant for a Vedic astrology app.
Use only the structured API facts below.
Do not invent planetary positions, dashas, Nakshatras, yogas, or compatibility scores.
If the needed fact is missing, ask for the missing input or say that this endpoint was not called.

User question:
{user_message}

FreeAstroAPI facts:
{json_from_relevant_endpoint}

Les endpoints dasha insights et Gochar timeline insights sont deja penses pour la recherche, le ranking et l'explication.

5. Ajouter de la memoire sans changer le theme

• Faits permanents : donnees de naissance, positions, timeline dasha, vargas, Panchang de naissance.
• Memoire de session : langue, ton, objectif, contexte relationnel, questions recentes.
• Faits frais : Panchang du jour, dasha actuelle, Gochar actuel, daily horoscope.

Cela evite que l'assistant traite une interpretation precedente comme un nouveau fait astrologique.

6. Format de reponse stable

Chaque reponse devrait avoir :

1. Reponse directe en une ou deux phrases.
2. Preuve tiree du payload API.
3. Interpretation pratique.
4. Question ou action optionnelle.

You are currently in Moon Mahadasha and Saturn Antardasha.
The API dasha payload shows Moon as the active Mahadasha lord and Saturn as the active sub-period lord for the selected reference date.
This usually focuses the reading on emotional security, home, responsibility, and long-term discipline.
If you want, I can compare this dasha with your current Gochar timeline.

Architecture d'app conseillee

User interface
  -> Your backend chat route
  -> Intent classifier
  -> FreeAstroAPI endpoint call
  -> Structured payload store
  -> LLM response generation
  -> Chat answer with endpoint-backed facts

Gardez x-api-key sur le serveur. Le client doit appeler votre backend, pas FreeAstroAPI directement.

Exemple Node.js minimal

const API_BASE = "https://api.freeastroapi.com";

async function getVedicProfile(birthData: Record<string, unknown>) {
  const response = await fetch(`${API_BASE}/api/v2/vedic/calculate`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.FREEASTROAPI_KEY || "",
    },
    body: JSON.stringify({
      ...birthData,
      tz_str: "AUTO",
      ayanamsha: "lahiri",
      vargas: [1, 9, 10],
      include_yogas: true,
      include_panchang: true,
      include_shadbala: true,
      include_ashtakavarga: true,
      dasha_levels: 3,
    }),
  });

  if (!response.ok) {
    throw new Error(`FreeAstroAPI request failed: ${response.status}`);
  }

  return response.json();
}

Strategie SEO pour votre bot

Si vous publiez l'app, creez des pages alignees sur les intentions de recherche :

• "AstroSage API alternative"
• "Vedic astrology API"
• "Kundli API for developers"
• "Dasha API"
• "Panchang API"
• "Astrology chatbot API"
• "Build an astrology bot"

Chaque page doit montrer la fonction, un exemple live, l'endpoint utilise et un lien vers la doc.

Erreurs a eviter

1. Ne laissez pas le LLM calculer un theme depuis des donnees brutes.
2. Ne negligez pas les fuseaux horaires et lieux historiques.
3. N'appelez pas des endpoints couteux a chaque message.
4. Ne melangez pas concepts occidentaux et vediques sans label.
5. Ne presentez pas une interpretation generee comme une donnee deterministe.
6. Ne stockez pas seulement le texte final. Stockez aussi le payload API.

Commencer

FreeAstroAPI fournit la couche de calcul pour themes vediques, dasha, Panchang, compatibilite, Gochar, horoscopes, themes occidentaux, synastrie, donnees lunaires et rendu graphique.

Commencez par l'endpoint Vedic calculate, ajoutez les intentions dasha et Panchang, puis etendez vers compatibilite, Gochar et daily horoscope.