Qu'est-ce que l'astrologie électionnelle et comment cette API l'automatise-t-elle ?

L'astrologie électionnelle consiste à choisir le meilleur moment astrologique pour entreprendre quelque chose d'important. Traditionnellement, les astrologues passent 1 à 4 heures à vérifier des centaines de moments candidats face à des critères pondérés. Notre API automatise tout le processus : envoyez une activité et une plage de dates, récupérez des fenêtres notées de 0 à 100 avec le détail des facteurs et une justification en langage naturel en moins de 2 secondes. Trois points de terminaison : /search pour les plages de dates, /evaluate pour les moments uniques, /glossary pour la taxonomie des activités.

Qu'est-ce qui différencie cela des API muhurta védiques comme Prokerala ou KundliAPI ?

Deux différences fondamentales. D'abord, nous faisons de l'astrologie électionnelle occidentale (zodiaque tropical, maisons Placidus, dignités planétaires traditionnelles) tandis que Prokerala/KundliAPI font du muhurta védique (sidéral, Choghadiya, Tithi). Ensuite, ils renvoient du favorable/défavorable binaire ou de simples listes de dates. Nous renvoyons des notes numériques de 0 à 100 avec le détail de 31 facteurs, des cartes de chaleur calendaires et un texte de justification en langage naturel. Personne d'autre ne propose de justificatifs de facteurs.

Combien coûte l'API d'astrologie électionnelle ?

Offre gratuite : 50 requêtes/mois. Starter : $11/mois pour 1 000 requêtes. Professional : $37/mois pour 55 000 requêtes. Business : $99/mois pour 220 000 requêtes. Enterprise : $399+/mois pour un usage illimité. À comparer aux logiciels électionnels de bureau à 300-700 $ une fois, ou aux consultations électionnelles professionnelles à 300-800 $ chacune.

Quelle est la rapidité de la recherche électionnelle sur de grandes plages de dates ?

Une recherche sur 90 jours s'achève en moins de 2 secondes au p95. Une recherche sur 367 jours (maximum) prend environ 4 à 5 secondes. L'évaluation d'un moment unique via /evaluate répond en moins de 300ms. La performance vient de l'architecture en deux passes : d'abord une carte de chaleur rapide au niveau du jour, puis un forage de précision dans les meilleurs jours uniquement. Le cache Redis offre une accélération x430 sur les requêtes répétées.

Quelles activités et quels événements l'API électionnelle prend-elle en charge ?

34 préréglages d'activités, tous examinés par des astrologues. Santé et corps : opération, soins dentaires, médication, conception, naissance, intervention esthétique, coupe de cheveux, sevrage. Relations : mariage, cour amoureuse, divorce, attribution de nom. Affaires et argent : entreprise, signature/contrat, lancement de produit, achat, vente, prêt, investissement, embauche, licenciement. Immobilier et déplacement : déménagement, relocalisation, bail, installation, voyage. Travail : examen, entretien, étude. Terre : semis, récolte. Plus les activités d'origine comme le mariage et le lancement. Chaque préréglage a des poids de facteurs dont la somme fait 100 et ses propres règles d'arrêt strict. GET /glossary/activities renvoie la liste complète avec les synonymes.

Comment fonctionne la règle de sécurité par zone du corps pour l'opération et les soins dentaires ?

Quand l'activité est « surgery », vous devez fournir extra_params.body_area (l'une des 15 zones : tête, visage, cou, gorge, bras, poitrine, cœur, estomac, dos, reins, organes reproducteurs, cuisses, genoux, mollets, pieds). L'API applique la règle traditionnelle : la Lune ne doit pas se trouver dans le signe du zodiaque qui gouverne cette zone du corps. L'activité « dental » (dents et mâchoire) partage la même logique de sécurité de la Lune en signe par zone du corps. En cas d'urgence, mettez emergency_mode: true pour passer outre les arrêts stricts avec un texte d'avertissement obligatoire.

Qu'est-ce que la carte de chaleur calendaire et comment l'utiliser ?

La carte de chaleur est un résumé des notes jour par jour pour toute la plage de recherche. Chaque jour reçoit une note composite (calculée à midi) et une tranche d'appréciation (excellent/bon/correct/médiocre/bloqué). Affichez-la comme un calendrier coloré dans votre interface. Les utilisateurs voient d'un coup d'œil quelles semaines sont favorables, puis creusent dans des jours précis pour des recommandations de fenêtres détaillées.

Que sont les justificatifs de facteurs et pourquoi sont-ils importants ?

Chaque fenêtre notée inclut un détail complet facteur par facteur : 31 évaluations de facteurs individuelles montrant le nom du facteur, le niveau de satisfaction (0,0-1,0), le texte d'observation, la contribution pondérée et le statut. C'est comme un justificatif pour la note. Les astrologues professionnels peuvent vérifier et défendre chaque recommandation auprès de leurs clients. Aucun concurrent ne fournit ce niveau de transparence.

Comment intégrer l'API électionnelle dans mon application ?

API REST standard. POST à /api/v3/electional/search avec activity, date_range et location. La réponse est un JSON contenant heatmap, top_windows, excluded_ranges. Pour un moment unique : POST à /evaluate. Pour les menus déroulants d'interface : GET /glossary/activities. SDK pour JavaScript, Python, PHP, Ruby. La plupart des développeurs intègrent le flux de base en moins d'une heure.

Puis-je l'utiliser avec des agents IA et des LLM ?

Oui, c'est conçu pour cela. L'outil MCP find_best_time est déjà enregistré pour l'intégration d'agents IA avec Claude, ChatGPT et des agents personnalisés. Mettez summary_mode: true pour une sortie compacte qui tient dans les fenêtres de contexte de chat (3 meilleures fenêtres + justification d'une ligne). Le point de terminaison /glossary/activities fournit les synonymes d'activités pour la classification d'intention LLM.

Qu'est-ce que l'avertissement personnel et comment fonctionne l'entrée du thème natal ?

Si vous fournissez un natal_chart (données de naissance) dans la requête, deux choses se produisent : (1) un modificateur natal ajuste les notes universelles de plus/moins 20 % au maximum en fonction des transits aux planètes natales, et (2) le détecteur PersonalAdvisory fait remonter les transits personnels majeurs (retour de Saturne, aspects durs des planètes lentes) même lorsque la note universelle est élevée. Cela évite de recommander une date universellement bonne mais personnellement désastreuse.

Quels arrêts stricts le moteur électionnel vérifie-t-il ?

23 vérificateurs d'arrêt strict dédiés évaluent : les éclipses solaires et lunaires (fenêtres asymétriques), les périodes de rétrogradation de Mercure/Vénus/Mars, la Lune hors course, les planètes combustes, les conflits de la Lune en signe par zone du corps (opération) et les conditions propres à l'activité. Les moments soumis à un arrêt strict sont entièrement exclus des résultats avec des explications dans le tableau excluded_ranges.

Puis-je imposer mes propres règles strictes, comme « la Lune doit être croissante » ?

Oui. En plus du moteur de notation de 0 à 100, vous pouvez passer des filtres de critères stricts personnalisés que chaque fenêtre renvoyée DOIT satisfaire. Les filtres pris en charge incluent moon_waxing (la Lune doit être croissante), planet_dignified (une planète choisie doit être dans sa dignité) et planet_angular (une planète choisie doit se trouver sur un angle). Ils agissent comme des barrières réussite/échec, et non comme de simples ajustements souples de la note : tout moment qui échoue à un filtre est exclu des résultats, ce qui vous permet d'imposer les règles électionnelles non négociables qu'exige votre tradition sans toucher aux poids des préréglages.

Signalez-vous les planètes combustes dans la fenêtre choisie ?

Oui. /search et /evaluate renvoient des combust_flags par significateur indiquant quelles planètes sont combustes (trop proches du Soleil) dans chaque fenêtre notée. Vous pouvez lire ces indicateurs pour repérer et éviter un significateur combuste avant de recommander une date. La combustion est déjà prise en compte dans la notation et les arrêts stricts, mais les combust_flags l'exposent explicitement par significateur afin que votre interface puisse avertir les utilisateurs ou leur permettre de filtrer les fenêtres combustes.

Quelle est la précision des calculs astronomiques ?

Données Swiss Ephemeris JPL DE431 avec une précision de 0,001 seconde d'arc. Même source de données que celle utilisée par la NASA. Les positions planétaires, les aspects, les phases lunaires, les éclipses, les rétrogradations et les ingrès sont tous calculés à partir de cette éphéméride de référence. Trois cycles de validation par des astrologues en exercice ont confirmé que tous les facteurs renvoient des résultats corrects.

Puis-je filtrer les résultats de recherche par heure de la journée ou jour de la semaine ?

Oui. Le paramètre filters accepte hours_from et hours_to (par ex. 9-21 pour la journée seulement), days_of_week (par ex. ['fri', 'sat', 'sun'] pour les mariages de week-end) et exclude_dates pour ignorer des dates précises. Cela réduit considérablement l'espace de recherche et améliore la pertinence.

Quels langages de programmation fonctionnent avec l'API électionnelle ?

Tout langage prenant en charge HTTP. SDK officiels pour JavaScript/Node.js, Python, PHP et Ruby. L'API renvoie du JSON standard. La plupart des développeurs l'intègrent avec fetch/axios dans les applications front-end ou requests/httpx dans les services back-end. Spécification OpenAPI complète disponible pour générer automatiquement des clients dans n'importe quel langage.

Existe-t-il une offre gratuite pour l'API électionnelle ?

Oui, 50 requêtes gratuites chaque mois. C'est suffisant pour tester l'ensemble du flux de recherche et d'évaluation, explorer les 34 préréglages d'activités et prototyper votre intégration avant de vous engager dans un forfait payant. L'offre gratuite inclut toutes les fonctionnalités - aucune restriction de fonctionnalité.

Comment le préréglage mariage gère-t-il Vénus rétrograde ?

Le préréglage mariage inclut Vénus rétrograde comme arrêt strict - tout moment pendant Vénus Rx est exclu des résultats avec une explication. Il applique également un avertissement de retour de Saturne si le thème natal montre un retour de Saturne dans la plage de recherche, et l'exclusion de la Lune hors course pour le timing de la cérémonie. La dignité de Vénus et la phase lunaire figurent parmi les facteurs les plus fortement pondérés.

Puis-je utiliser l'API pour le timing de lancement d'entreprise ?

Oui, le préréglage entreprise est l'une des 34 activités prises en charge. Il priorise les conditions de Mercure (en évitant la rétrogradation et la combustion), les aspects de Jupiter pour la croissance, la phase de la Lune (croissante de préférence) et la force de la maison X. Les arrêts stricts incluent Mercure Rx, les éclipses et la Lune hors course. Il existe des préréglages distincts pour signature/contrat, lancement de produit, achat, vente et prêt, afin que vous puissiez choisir celui qui correspond à l'événement professionnel exact.

Comment notez-vous le timing du mariage, de la cour amoureuse et du divorce ?

Chacun est son propre préréglage. Le mariage et la cour amoureuse pondèrent fortement les conditions de Vénus (dignité, aspects, absence de rétrogradation et de combustion), favorisent une Lune croissante et excluent la Lune hors course et les éclipses. Le divorce utilise des facteurs de domaine de vie différents - il ne cherche pas tant un moment « chanceux » qu'à éviter les pires conditions de Lune et de maléfique sur angle pour une rupture nette. Les trois renvoient des notes de 0 à 100 avec appréciations et justification par fenêtre, pour que les utilisateurs comprennent pourquoi une date l'emporte sur une autre.

Puis-je trouver le meilleur moment pour une coupe de cheveux ou une intervention esthétique ?

Oui. Les préréglages coupe de cheveux et intervention esthétique utilisent le timing lunaire traditionnel - une Lune croissante pour la croissance (idéale pour les coupes de cheveux où l'on souhaite une repousse plus fournie) et des facteurs de Lune en signe pour la zone du corps. Ce sont des fonctionnalités quotidiennes de soin de soi pour les applications de bien-être. Envoyez l'activité « haircut » ou « cosmetic procedure » avec une plage de dates et un lieu, et récupérez des fenêtres notées avec des appréciations allant d'excellent à médiocre.

L'API prend-elle en charge le timing de semis et de récolte pour l'agriculture ?

Oui. Les préréglages semis et récolte utilisent les préférences de Lune croissante/décroissante et les mansions lunaires, la base traditionnelle du timing électionnel agricole. Le semis favorise généralement une Lune croissante pour les cultures aériennes ; la récolte favorise une Lune décroissante pour la conservation. Les deux renvoient des notes de 0 à 100, une carte de chaleur calendaire pour toute la saison et une justification expliquant la phase lunaire et le raisonnement de la Lune en signe pour chaque fenêtre.

Quelles appréciations l'API renvoie-t-elle en plus de la note ?

Chaque note de 0 à 100 correspond à une appréciation : excellent (90-100), bon (75-89), correct (60-74), prudence (40-59), médiocre (0-39). L'appréciation donne à votre interface une étiquette et une tranche de couleur instantanées sans que vous ayez à définir de seuils. La carte de chaleur calendaire utilise la même notation, ce qui permet aux utilisateurs de balayer tout un mois et de repérer les jours excellents d'un coup d'œil, puis de creuser dans des fenêtres précises.

Quelles langues le texte de justification prend-il en charge ?

9 langues : anglais, russe, allemand, espagnol, français, italien, portugais, chinois et hindi. Réglez le paramètre language et la justification en langage naturel, les observations de facteurs et les explications de plages exclues reviennent localisées. Cela vous permet de proposer des fonctionnalités de timing astrologique à un public mondial sans rédiger vos propres traductions du texte de raisonnement.

Puis-je contrôler la précision des fenêtres candidates ?

Oui, avec le paramètre granularity : 1m, 5m, 15m, 1h, 4h ou 1d. Utilisez 1d ou 4h pour un balayage rapide sur une saison entière, puis 1m ou 5m pour fixer une heure de début exacte de cérémonie ou d'opération à l'intérieur des meilleurs jours. La recherche en deux passes reste rapide - la carte de chaleur au niveau du jour s'exécute d'abord, puis la passe de précision creuse dans les meilleurs jours uniquement à la granularité choisie.

Les 34 préréglages d'activités sont-ils examinés par de vrais astrologues ?

Oui. Le catalogue est passé de l'ensemble d'origine à 34 préréglages sur trois vagues de publication (vagues 1 à 3), chacune examinée par des astrologues. Les relecteurs ont vérifié les poids des facteurs, les règles d'arrêt strict et la logique propre à chaque activité - Lune en signe par zone du corps pour l'opération et les soins dentaires, accent sur Vénus pour le mariage et la cour amoureuse, Lune croissante/décroissante pour le semis et la récolte. Les règles suivent la pratique électionnelle traditionnelle, pas une notation arbitraire.

Puis-je afficher le thème d'un moment recommandé sans un second appel ?

Oui. Chaque fenêtre notée dans /search et /evaluate renvoie désormais body_positions - les positions planétaires complètes (signe, degré et maison) à cet instant précis. Vous les lisez directement dans la réponse et dessinez le thème de tout moment recommandé dans votre interface, sans requête supplémentaire. Cela supprime un aller-retour : choisissez une meilleure fenêtre, affichez sa roue à partir de la même réponse et montrez aux utilisateurs le ciel réel derrière la note.

Comment savoir pourquoi un moment a obtenu une bonne note ?

Deux éléments fonctionnent ensemble. Chaque fenêtre porte désormais key_significators - les planètes et maîtres précis que le moteur a réellement notés pour cette activité - pour que vous puissiez montrer pourquoi un moment se classe là où il est, et pas juste un chiffre. La notation gradue aussi la combustion selon la sévérité et le rôle, pas un simple indicateur oui/non : un significateur primaire combuste fait chuter la note bien plus qu'un corps secondaire combuste, donc le classement reflète à quel point la combustion compte vraiment pour cette activité. Associez key_significators au détail des 31 facteurs et vous pouvez expliquer chaque recommandation.

Puis-je obtenir les meilleures heures du jour pour un domaine de vie précis comme la carrière ou l'amour ?

Oui. Personal Power Hours accepte un filtre life_area ou activity (carrière, amour et 12 autres clés canoniques de domaine de vie, plus des alias plus conviviaux). Passer un filtre repondère les contributions sous-jacentes en utilisant la même attribution de maison et de signification planétaire que le moteur d'horoscope, puis reclasse les fenêtres du jour spécifiquement pour ce domaine. Laissez le filtre vide et la réponse inclut per_area_best, la meilleure fenêtre pour chaque domaine de vie en un seul appel, pour construire un tableau de bord « meilleures heures du jour » sans requêtes multiples.

Personal Power Hours fonctionne-t-il en voyage ou dans un autre fuseau horaire ?

Oui. Chaque fenêtre est renvoyée à la fois en heure locale résolue (avec un fuseau horaire IANA approprié et un décalage UTC) et en UTC, et la colonne vertébrale des heures planétaires sous-jacente est calculée par rapport au fuseau horaire réel que vous transmettez dans la requête, pas une horloge locale du serveur naïve. Cela signifie que le classement est correct que vous interrogiez la ville de résidence de la personne ou une ville où elle voyage actuellement - passez location_override et la réponse reflète le bon lever, coucher du soleil et les bonnes limites d'heures pour ce lieu.

Que signifie day_quality dans la réponse Personal Power Hours ?

day_quality est un indicateur d'honnêteté, l'un de active, quiet, voc_dominated ou polar_degraded. Si aucune fenêtre du jour ne franchit le seuil de favorabilité, l'API renvoie quiet au lieu d'inventer un faux pic. Si la Lune hors course domine la journée, elle renvoie voc_dominated et fait quand même remonter la meilleure fenêtre avant le hors-course. Près des pôles, où la colonne de 24 heures ne peut pas être calculée de manière fiable, elle renvoie polar_degraded et se rabat sur la seule couche de superposition avec un avertissement. La notation est entièrement déterministe - aucun hasard - donc la même requête renvoie toujours le même résultat.

Astrologie électionnelle

Trouvez le meilleur moment pour tout. Noté de 0 à 100.

Première API REST d'astrologie électionnelle occidentale avec notation numérique.

Carte de chaleur calendaire, 34 préréglages d'activités (opération, mariage, lancement, semis, coupe de cheveux et plus), détail des facteurs avec justificatifs, justification en langage naturel dans 9 langues. Aucun concurrent ne propose cela. Marché vide confirmé.

Voir la documentation

0-100

Notation numérique

Préréglages d'activités

Évaluateurs de facteurs

<2s

Recherche sur 90 jours

Première API REST électionnelle occidentale

Précision Swiss Ephemeris

Compatible MCP pour agents IA

Nouveau : Personal Power Hours, timing natal à la minute près

Logiciels de bureau uniquement (Solar Fire, Janus) : pas d'API, pas de notation, interface des années 1990
Outils web (Astro-Seek) : notation opaque, 90 jours maximum, pas d'export
API védiques (Prokerala, KundliAPI) : uniquement favorable/défavorable en binaire, pas d'occidentale
KundliAPI renvoie de simples listes de dates sans notes, sans cartes de chaleur, sans justifications
Aucune API existante ne renvoie le détail des facteurs, de justification en langage naturel ni de carte de chaleur calendaire

Transformez avec

Notation numérique de 0 à 100 avec justificatifs transparents, facteur par facteur
Carte de chaleur calendaire pour balayer visuellement une plage de dates d'un coup d'œil
34 préréglages d'activités : opération, mariage, lancement, contrats, semis, coupe de cheveux, divorce et plus
Justification en langage naturel par fenêtre dans 9 langues : « pourquoi ce moment est favorable »
Outil find_best_time appelable via MCP pour les agents IA et l'intégration LLM

Performance de l'API électionnelle

Conçue pour la production, validée par des astrologues

0-100

Plage de notation

Préréglages d'activités

31 + 23

Facteurs + arrêts stricts

<2 secondes

Recherche sur 90 jours

<300ms

Évaluation unique

293 tests

Couverture de tests

Fonctionnalités complètes d'astrologie électionnelle

31 facteurs, 23 arrêts stricts, 34 préréglages d'activités, 9 langues, 3 points de terminaison

Recherche sur plage de dates

Évaluation d'un moment unique

34 préréglages d'activités

Moteur de notation

Intégration IA et LLM

Appréciations et localisation

Fenêtres prêtes pour le thème

Notation explicable

Personal Power Hours (Nouveau)

Qu'est-ce que l'API d'astrologie électionnelle ? Guide complet pour développeurs

La première API REST pour trouver les moments astrologiquement optimaux - avec de vraies notes

Qu'est-ce que l'astrologie électionnelle ? C'est la pratique ancienne consistant à choisir le meilleur moment pour entreprendre quelque chose d'important : une opération, un mariage, le lancement d'une entreprise, la signature d'un contrat, et même planter un jardin ou se faire couper les cheveux. L'API couvre désormais 34 préréglages d'activités, chacun examiné par des astrologues sur trois vagues de publication. Les astrologues professionnels facturent entre 300 et 800 $ par consultation électionnelle, passant 1 à 4 heures à vérifier manuellement des centaines de moments candidats. Notre API d'astrologie électionnelle est le premier point de terminaison REST qui automatise tout ce processus avec une sortie JSON structurée. Vous envoyez une activité et une plage de dates, et vous récupérez une note de 0 à 100 pour chaque moment candidat, une carte de chaleur calendaire montrant les bons et mauvais jours d'un coup d'œil, un détail facteur par facteur expliquant exactement pourquoi chaque note est ce qu'elle est, et un texte de justification en langage naturel dans 9 langues (en, ru, de, es, fr, it, pt, zh, hi). Aucun autre fournisseur d'API ne propose de notation électionnelle occidentale - nous avons vérifié Solar Fire, Janus, AstroApp, Prokerala, AstrologyAPI.com, KundliAPI, VedicRishi. Lacune confirmée partout. La pile védique renvoie des classifications muhurta binaires, pas des notes numériques. C'est un marché réellement vide.

Comment fonctionne l'API d'astrologie électionnelle ?

Trois points de terminaison alimentent tout le système.

POST /search accepte une activité (comme « surgery » ou « marriage »), une plage de dates (jusqu'à 367 jours) et un lieu.

Il exécute une recherche en deux passes : d'abord une passe rapide de carte de chaleur au niveau du jour, notant chaque jour à midi, puis une passe de précision qui creuse dans les meilleurs jours à une granularité configurable (fenêtres de 1m, 5m, 15m, 1h, 4h ou 1d).

Le résultat est une carte de chaleur calendaire avec des jours colorés par niveau, les meilleures fenêtres classées avec leurs notes individuelles, les plages de dates exclues (éclipses, rétrogradations, etc.) avec leurs explications, et une justification en langage naturel par fenêtre.

POST /evaluate note un moment précis unique - parfait pour vérifier « cette date est-elle favorable ? ».

GET /glossary/activities renvoie les 34 activités prises en charge avec leurs synonymes, pour la reconnaissance d'intention LLM et les menus déroulants d'interface.

Recherche en deux passes : d'abord la carte de chaleur, puis le forage de précision dans les meilleurs jours

1 min read

Qu'est-ce qui rend cette API électionnelle unique ?

Cinq choses qu'aucun concurrent ne propose : (1) une notation numérique de 0 à 100 avec courbes de saturation - ni oui/non binaire, ni vague « bon/mauvais ».

(2) Une carte de chaleur calendaire - une notation visuelle jour par jour pour toute une plage de dates.

(3) Un détail facteur par facteur (« justificatifs ») - chaque note est accompagnée de 31 évaluations de facteurs individuelles montrant le niveau de satisfaction, l'observation et la contribution à la note finale.

Les astrologues professionnels peuvent défendre chaque recommandation.

(4) Une justification en langage naturel dans 9 langues - des explications générées automatiquement par fenêtre, prêtes à être affichées aux utilisateurs ou transmises aux LLM.

(5) 34 préréglages d'activités aux poids ajustés - une élection de mariage priorise les conditions de Vénus différemment d'une élection d'opération, et un semis pondère la phase lunaire et la fertilité de la Lune en signe encore autrement.

Chaque préréglage possède des poids calibrés professionnellement dont la somme fait 100, examinés par des astrologues sur trois vagues de publication.

Seule API avec notation numérique + carte de chaleur + justificatifs de facteurs + justification en langage naturel

1 min read

Quelles activités l'API électionnelle prend-elle en charge ?

34 préréglages d'activités, tous examinés par des astrologues sur trois vagues de publication.

Santé et corps : opération, soins dentaires (dents et mâchoire), médication, conception, naissance, intervention esthétique, coupe de cheveux, sevrage.

Relations et événements de vie : mariage, cour amoureuse, divorce, attribution de nom.

Affaires et argent : entreprise, signature/contrat, lancement de produit, achat, vente, prêt, investissement, embauche, licenciement.

Bien immobilier et déplacement : déménagement, relocalisation, bail, installation, voyage.

Travail et apprentissage : examen, entretien, étude.

Terre et croissance : semis, récolte.

Plus les activités d'origine comme le mariage et le lancement.

Chaque préréglage définit ses propres poids de facteurs et ses règles d'arrêt strict.

L'opération et les soins dentaires imposent la sécurité de la Lune en signe selon la zone du corps : l'opération exige un paramètre body_area (15 zones : tête, visage, cou, gorge, bras, poitrine, cœur, estomac, dos, reins, organes reproducteurs, cuisses, genoux, mollets, pieds) et la règle traditionnelle selon laquelle la Lune ne doit pas se trouver dans le signe qui gouverne la partie du corps opérée.

Le mariage et la cour amoureuse pondèrent les conditions de Vénus et évitent Vénus rétrograde.

Le semis et la récolte utilisent les préférences de Lune croissante/décroissante et les mansions lunaires.

Chaque activité est documentée dans le point de terminaison /glossary/activities avec ses synonymes.

34 préréglages d'activités avec règles de sécurité et poids de facteurs propres à chaque activité

2 min read

Comment fonctionne le moteur de notation sous le capot ?

Chaque préréglage définit 31 facteurs avec des poids individuels dont la somme fait 100.

Pour chaque moment candidat, chaque évaluateur de facteur renvoie une note de satisfaction (0,0-1,0), une chaîne d'observation et des détails optionnels.

Ces satisfactions brutes passent par des courbes de saturation (configurables par préréglage) avant l'agrégation pondérée en une note finale de 0 à 100, associée à une appréciation : excellent (90-100), bon (75-89), correct (60-74), prudence (40-59), médiocre (0-39).

Les arrêts stricts sont vérifiés séparément par 23 vérificateurs dédiés : éclipses, planètes rétrogrades, Lune hors course (void-of-course), planètes combustes, maléfique sur angle, vérifications de planète sur cuspide, et conditions propres à l'activité comme la Lune en signe selon la zone du corps pour l'opération et les soins dentaires.

Un moment soumis à un arrêt strict est entièrement exclu avec une explication.

En plus des vérificateurs intégrés, vous pouvez passer vos propres filtres de critères stricts - moon_waxing, planet_dignified, planet_angular - que chaque fenêtre renvoyée doit satisfaire, transformant des préférences de notation souples en barrières non négociables.

Chaque fenêtre porte aussi des combust_flags par significateur, ce qui vous permet de repérer et d'écarter les significateurs combustes.

Si un thème natal est fourni, un modificateur natal (plafonné à plus ou moins 20 %) ajuste la note universelle, et le détecteur PersonalAdvisory fait remonter les transits majeurs comme le retour de Saturne même lorsque la note universelle est élevée.

31 facteurs avec courbes de saturation + 23 vérificateurs d'arrêt strict par moment

2 min read

Que renvoie désormais chaque fenêtre notée ?

Deux améliorations de la réponse rendent les moments recommandés autonomes et explicables.

D'abord, chaque fenêtre notée porte body_positions : les positions planétaires complètes (signe, degré et maison) à cet instant précis.

Vous affichez le thème de tout moment recommandé directement depuis la réponse de search ou d'evaluate, sans second appel d'API - la même charge utile anime à la fois la note de 0 à 100 et la roue que vous dessinez dans votre interface.

Ensuite, chaque fenêtre nomme désormais ses key_significators : les planètes et maîtres précis que le moteur a réellement notés pour cette activité.

Une fenêtre de mariage fait remonter les maîtres de Vénus et de la Lune qu'elle a pesés ; une fenêtre d'opération fait remonter les corps qui comptaient pour l'intervention.

Vous montrez ainsi aux utilisateurs pourquoi un moment se classe là où il est plutôt qu'un chiffre nu.

La notation gradue aussi la combustion selon la sévérité et le rôle désormais, pas un simple indicateur oui/non - un significateur primaire combuste fait chuter la note bien plus qu'un corps secondaire combuste, donc les classements reflètent à quel point la combustion compte vraiment pour cette activité.

body_positions + key_significators sur chaque fenêtre, avec une combustion graduée selon le rôle

1 min read

Comment intégrer l'API électionnelle ?

REST standard.

Envoyez un POST à /api/v3/electional/search avec votre activité, votre plage de dates et votre lieu.

Récupérez du JSON contenant heatmap, top_windows, excluded_ranges et summary.

Pour vérifier un moment unique, faites un POST à /evaluate.

Pour les menus déroulants d'interface ou la reconnaissance d'intention LLM, GET /glossary/activities renvoie les 34 activités avec leurs synonymes.

Paramètres optionnels : natal_chart pour une notation personnalisée, filters pour restreindre par heure de la journée et jour de la semaine, granularity (1m/5m/15m/1h/4h/1d) pour la précision des fenêtres, language pour le texte de justification (en, ru, de, es, fr, it, pt, zh, hi), summary_mode pour une sortie compacte adaptée aux LLM, emergency_mode pour une opération qui ne peut attendre.

L'API est conçue pour être appelable via MCP - l'outil find_best_time est déjà enregistré pour l'intégration des agents IA.

3 points de terminaison, compatible MCP, summary_mode adapté aux LLM

1 min read

Qu'est-ce que Personal Power Hours ?

Qu'est-ce que Personal Power Hours ? Personal Power Hours est un nouveau point de terminaison, POST /api/v3/electional/personal-hours, qui classe les minutes d'une seule journée selon leur favorabilité astrologique calculée à partir du thème natal d'une personne.

C'est différent du point de terminaison /planetary-hours existant, qui renvoie les mêmes 24 heures chaldéennes inégales pour quiconque se trouve au même endroit - une liste générique, pas personnelle.

Personal Power Hours reprend cette colonne vertébrale de 24 heures et repondère chaque heure selon la condition de sa planète maîtresse dans votre propre thème : dignité essentielle, angularité, secte, s'il s'agit d'une planète bénéfique ou maléfique naturelle, et si elle est actuellement combuste, cazimi ou rétrograde.

L'heure gouvernée par le maître de votre propre thème devient le point culminant de votre journée.

Par-dessus cette colonne vertébrale, le moteur superpose des événements précis - la Lune en transit et les planètes rapides touchant vos points natals, ainsi que les minutes exactes où votre degré ascendant ou culminant conjoint un point natal.

Une Lune hors course atténue la note ; des impacts durs de Mars ou Saturne et une heure-maîtresse combuste ajoutent des fenêtres de prudence.

La réponse fournit des fenêtres de pointe, favorables et de prudence en heure locale et en UTC, une note de 0 à 100, la planète maîtresse, des étiquettes de tonalité et d'activité, les meilleures fenêtres par domaine de vie, et un indicateur day_quality honnête pour qu'une journée calme soit signalée comme calme au lieu d'être gonflée de pics fabriqués.

Timing à la minute près classé selon VOTRE propre thème, pas une liste générique par lieu

2 min read

En quoi Personal Power Hours diffère-t-il des heures planétaires ?

Les heures planétaires classiques divisent le jour et la nuit en 12 heures inégales chacune, gouvernées par une rotation fixe de planètes - la même séquence pour toute personne se trouvant dans la même ville le même jour.

Cela vous indique « c'est l'heure de Mars, c'est l'heure de Vénus » et s'arrête là.

Personal Power Hours part de cette même colonne vertébrale de 24 heures mais renote chaque heure à l'aide de votre thème natal : la condition de la planète maîtresse de chaque heure dans votre thème de naissance, pas seulement son identité.

Deux personnes dans la même ville obtiennent la même liste d'heures planétaires mais deux classements Personal Power Hours différents, car l'heure du Soleil peut être excellente pour quelqu'un avec un Soleil natal fort et médiocre pour quelqu'un dont le Soleil natal est combuste ou mal placé.

Le point de terminaison ajoute aussi une couche qu'aucun outil classique d'heures planétaires ne fournit : les impacts de la Lune en transit et des planètes rapides sur vos points natals, et les déclencheurs rotationnels de l'Ascendant/Milieu du Ciel - les minutes précises où votre degré ascendant ou culminant touche quelque chose dans votre thème de naissance.

Même personne, même ville : deux classements différents selon leur thème natal

1 min read

Qui utilise l'API d'astrologie électionnelle ?

Cinq segments principaux : (1) les développeurs d'applications d'astrologie qui créent des fonctionnalités de timing - la carte de chaleur et les fenêtres notées sont des données d'interface prêtes à afficher, et 34 activités couvrent presque toute question du type « meilleur moment pour X » que posent les utilisateurs.

(2) Les plateformes de mariage et d'événements qui ajoutent des recommandations de dates - les préréglages mariage gèrent automatiquement Vénus Rx, les éclipses, la Lune hors course et le retour de Saturne.

(3) Les applications de santé et de bien-être - les préréglages opération et soins dentaires imposent la sécurité de la Lune en signe selon la zone du corps, tandis que le timing de coupe de cheveux, d'intervention esthétique et de médication alimentent des fonctionnalités quotidiennes de soin de soi.

(4) Les créateurs d'agents IA utilisant les outils MCP - l'outil find_best_time fonctionne directement avec l'appel de fonctions d'OpenAI/Anthropic.

(5) Les astrologues professionnels qui développent leur activité - au lieu de 1 à 4 heures par consultation, ils obtiennent des résultats notés instantanés avec les justificatifs de facteurs à examiner et présenter aux clients.

L'API gère le calcul ; l'astrologue apporte l'expertise et la touche personnelle.

1 min read

Use Cases

Applications de mariage et d'événements

Recommandez les dates de mariage optimales avec analyse de Vénus/Lune, alerte de retour de Saturne, évitement des éclipses. Les justificatifs de facteurs expliquent chaque recommandation.

Intégration d'agents IA (MCP)

Outil MCP find_best_time pour ChatGPT, Claude et les agents IA personnalisés. Le mode résumé renvoie un JSON compact adapté aux fenêtres de contexte de chat.

Outils de planification d'opérations

Sécurité hippocratique avec 15 zones du corps. Application de la règle de la Lune en signe. Dérogation en mode urgence avec texte d'avertissement obligatoire.

Plateformes de lancement d'entreprise

Évitement de Mercure rétrograde, exclusion de la Lune hors course, optimisation des aspects de Jupiter pour le timing des affaires.

Tableaux de bord pour astrologues professionnels

Les justificatifs facteur par facteur permettent aux astrologues de vérifier et de présenter des résultats notés aux clients. 1 à 4 heures de travail en moins de 2 secondes.

Timing immobilier et juridique

Optimisation de la signature de contrat, de l'achat immobilier, du bail, du déménagement, de la relocalisation et de l'installation avec des préréglages propres à chaque activité.

Applications de santé et de soin de soi

Sécurité par zone du corps pour les soins dentaires (dents/mâchoire) et l'opération, plus le timing quotidien pour la coupe de cheveux, l'intervention esthétique, la médication et le sevrage.

Applications de relations et d'événements de vie

Mariage, cour amoureuse, divorce, conception, naissance et attribution de nom - chacun avec des facteurs Vénus, Lune et domaine de vie ajustés.

Applications d'agriculture et de jardinage

Timing de semis et de récolte utilisant les préférences de Lune croissante/décroissante et les mansions lunaires pour la fertilité et le rendement.

Outils de carrière et de travail

Meilleur timing pour les examens, entretiens, sessions d'étude, embauches et licenciements - 34 activités couvrent toute la journée de travail.

Applications de timing personnel quotidien

Personal Power Hours classe les minutes du jour selon le propre thème natal de l'utilisateur - un différenciateur réel par rapport aux listes de transits non classées ou aux textes d'humeur vagues.

Technical Specifications

Points de terminaison	3 (search, evaluate, glossary)
Plage de notation	0-100 numérique avec courbes de saturation
Préréglages d'activités	34 (opération, mariage, entreprise, semis, coupe de cheveux, etc.)
Appréciations	excellent 90-100, bon 75-89, correct 60-74, prudence 40-59, médiocre 0-39
Langues	9 (en, ru, de, es, fr, it, pt, zh, hi)
Évaluateurs de facteurs	31 évaluations par facteur et par moment
Vérificateurs d'arrêt strict	23 vérificateurs d'exclusion dédiés
Plage de recherche	Jusqu'à 367 jours par requête
Vitesse de recherche	<2s pour une recherche sur 90 jours (p95)
Vitesse d'évaluation	<300ms pour la notation d'un moment unique
Granularité	1m / 5m / 15m / 1h / 4h / 1d configurable
Sécurité opération et soins dentaires	Règle de la Lune en signe par zone du corps (15 zones)
Avertissement personnel	Retour de Saturne, transits durs des planètes lentes au natal
Sortie	Carte de chaleur + fenêtres classées + plages exclues + justification en langage naturel
Intégration MCP	Outil find_best_time enregistré
Éphéméride	Swiss Ephemeris JPL DE431
Cache	Pool Redis par boucle d'événements, TTL 24h, accélération à chaud x430
Détail par fenêtre	Positions du thème + significateurs notés par fenêtre
Personal Power Hours	POST /personal-hours, timing natal classé à la minute près
Méthode Personal Hours	Colonne de 24 heures (pondérée par condition) + superposition Lune/planètes rapides/angulaire

API électionnelle vs concurrents

Feature	Astrology API	Others
Notation électionnelle occidentale	0-100 numérique	Aucune (Solar Fire : booléen, védique : binaire)
Carte de chaleur calendaire	Notée jour par jour	Non disponible
Détail des facteurs	31 facteurs avec justificatifs	Non disponible
Justification en langage naturel	Texte par fenêtre	Non disponible
Préréglages d'activités	34 aux poids ajustés	KundliAPI : 9 (védique uniquement, sans notes)
Accès API	API REST JSON	Bureau uniquement ou API védique uniquement
Plage de recherche	Jusqu'à 367 jours	90 jours maximum (outils web)
Sécurité opération	Règle hippocratique des 15 zones	Non disponible
Compatible MCP/LLM	Outil intégré + summary_mode	Non disponible
Prix	À partir de $11/mois	$300-700/mois (logiciel de bureau)
Timing personnel à la minute près	Personal Power Hours : classé selon le thème natal, 0-100 par fenêtre	TimePassages/Astro Gold/The Pattern/Co-Star : liste de transits non classée ou texte d'humeur vague

API d'astrologie associées

Transit API

Transits planétaires en temps réel alimentant les évaluateurs de facteurs électionnels

Planetary Hours API

Heures planétaires traditionnelles - l'un des 31 facteurs électionnels

Horary API

Astrologie horaire partageant le même moteur de calcul

Natal Chart API

Thèmes de naissance pour une notation électionnelle personnalisée

Documentation de l'API

Référence complète des points de terminaison avec exemples de requête/réponse

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Tarifs Simples et Transparents

Commencez gratuitement, evoluez selon vos besoins. Pas de frais caches.

Toujours Gratuit

Sans Carte de Credit

Parfait pour apprendre, tester et petits projets personnels

100 appels API/mois

Cartes natales de base

5 systemes de maisons

Support communautaire

Pro

11€/mois

Pour petites apps et projets personnels

Tous les endpoints de base
12 systemes de maisons
Support email

Meilleur Rapport Qualite-Prix

Pro Plus

21€/mois

Pour apps en croissance et trafic moyen

Tous les endpoints ameliores
18 systemes de maisons
Interpretations IA
Support email prioritaire

Ultra

37€/mois

Pour applications d'astrologie professionnelles

Credit math ↓

Tous les endpoints premium
23 systemes de maisons
Interpretations IA avancees
Support prioritaire

Plans Haut Volume

Pour applications a echelle entreprise

Business

99€/mois

Pour applications a haut volume

Credit math ↓

TOUS les endpoints
Pret pour marque blanche
Affinage IA personnalise
Support telephonique

ILLIMITE

Enterprise

399€+par mois

Requetes illimitees avec infrastructure dediee

Infrastructure serveur dediee
Moins de 300ms garanti
Support dedie 24/7
99,99% uptime SLA

Tous les plans incluent documentation complete et SDKs

Questions? Parlez a notre equipe

Questions fréquentes sur l'API d'astrologie électionnelle

Réponses techniques pour les développeurs créant des fonctionnalités de timing

Complétez votre suite d'outils de timing astrologique

L'API électionnelle donne le meilleur d'elle-même combinée à nos autres outils de timing et de calcul.

Transit API Planetary Hours Horary API Natal Chart API Lunation API

Commencez à trouver

Première API REST d'astrologie électionnelle occidentale. Notation de 0 à 100, 34 préréglages d'activités, justificatifs de facteurs, 9 langues. Aucun concurrent ne propose cela.

Commencer gratuitement Voir la documentation

50 requêtes gratuites/mois

Précision Swiss Ephemeris

Aucuns frais de configuration

L'offre gratuite inclut toutes les fonctionnalités

Trouvez le meilleur moment pour tout. Noté de 0 à 100.

Aucune API électionnelle occidentale n'existe

Première API REST électionnelle conçue à cet effet

Performance de l'API électionnelle

Fonctionnalités complètes d'astrologie électionnelle

Recherche sur plage de dates

Évaluation d'un moment unique

34 préréglages d'activités

Moteur de notation

Intégration IA et LLM

Appréciations et localisation

Fenêtres prêtes pour le thème

Notation explicable

Personal Power Hours (Nouveau)

Qu'est-ce que l'API d'astrologie électionnelle ? Guide complet pour développeurs

Comment fonctionne l'API d'astrologie électionnelle ?

Qu'est-ce qui rend cette API électionnelle unique ?

Quelles activités l'API électionnelle prend-elle en charge ?

Comment fonctionne le moteur de notation sous le capot ?

Que renvoie désormais chaque fenêtre notée ?

Comment intégrer l'API électionnelle ?

Qu'est-ce que Personal Power Hours ?

En quoi Personal Power Hours diffère-t-il des heures planétaires ?

Qui utilise l'API d'astrologie électionnelle ?

Use Cases

Applications de mariage et d'événements

Intégration d'agents IA (MCP)

Outils de planification d'opérations

Plateformes de lancement d'entreprise

Tableaux de bord pour astrologues professionnels

Timing immobilier et juridique

Applications de santé et de soin de soi

Applications de relations et d'événements de vie

Applications d'agriculture et de jardinage

Outils de carrière et de travail

Applications de timing personnel quotidien

Technical Specifications

API électionnelle vs concurrents

API d'astrologie associées

Transit API

Planetary Hours API

Horary API

Natal Chart API

Documentation de l'API

References & Standards

Tarifs Simples et Transparents

Toujours Gratuit

Pro

Pro Plus

Ultra

Plans Haut Volume

Business

Enterprise

Questions fréquentes sur l'API d'astrologie électionnelle

Qu'est-ce que l'astrologie électionnelle et comment cette API l'automatise-t-elle ?

Qu'est-ce qui différencie cela des API muhurta védiques comme Prokerala ou KundliAPI ?

Combien coûte l'API d'astrologie électionnelle ?

Quelle est la rapidité de la recherche électionnelle sur de grandes plages de dates ?

Quelles activités et quels événements l'API électionnelle prend-elle en charge ?

Comment fonctionne la règle de sécurité par zone du corps pour l'opération et les soins dentaires ?

Qu'est-ce que la carte de chaleur calendaire et comment l'utiliser ?

Que sont les justificatifs de facteurs et pourquoi sont-ils importants ?

Comment intégrer l'API électionnelle dans mon application ?

Puis-je l'utiliser avec des agents IA et des LLM ?

Qu'est-ce que l'avertissement personnel et comment fonctionne l'entrée du thème natal ?

Quels arrêts stricts le moteur électionnel vérifie-t-il ?

Puis-je imposer mes propres règles strictes, comme « la Lune doit être croissante » ?

Signalez-vous les planètes combustes dans la fenêtre choisie ?

Quelle est la précision des calculs astronomiques ?

Puis-je filtrer les résultats de recherche par heure de la journée ou jour de la semaine ?

Quels langages de programmation fonctionnent avec l'API électionnelle ?

Existe-t-il une offre gratuite pour l'API électionnelle ?

Comment le préréglage mariage gère-t-il Vénus rétrograde ?

Puis-je utiliser l'API pour le timing de lancement d'entreprise ?

Comment notez-vous le timing du mariage, de la cour amoureuse et du divorce ?

Puis-je trouver le meilleur moment pour une coupe de cheveux ou une intervention esthétique ?

L'API prend-elle en charge le timing de semis et de récolte pour l'agriculture ?

Quelles appréciations l'API renvoie-t-elle en plus de la note ?

Quelles langues le texte de justification prend-il en charge ?

Puis-je contrôler la précision des fenêtres candidates ?