Reports API - 16 rapports PDF prêts à l'emploi à votre marque

Tu envoies une date de naissance, tu reçois un document prêt à l’emploi. Pas du JSON à partir duquel tu dois créer un PDF, mais le PDF lui-même : mis en page page par page, avec ton logo, le titre de ton rapport et sans aucune mention de nous à l’intérieur.

Seize de ces rapports sont déjà opérationnels. Avec le gestionnaire, l’historique des exportations et cinq narratifs IA, cela représente 23 chemins sous /v1/reports/*.

Catalogue

Chaque ligne a un exemple prêt à l’emploi. Ce n’est pas une maquette : le fichier est généré par le même appel que celui imprimé dans la documentation de cet endpoint, et est réédité avec les modèles.

Le nombre de pages est celui donné par cet exemple, mesuré le 2026-09-21. Il varie en fonction de la carte : plus d’aspects signifie plus de lignes, et relocation ajoute deux à trois pages par ville (4 pages pour une ville, 13 pour cinq).

Endpoint	Contenu	Pages	Crédits	Exemple
/v1/reports/natal	La Grande Triade, planètes, maisons, aspects	3	5 000	PDF
/v1/reports/synastry	Aspects inter-cartes de deux thèmes, équilibre des éléments	2	5 000	PDF
/v1/reports/transit-yearly	Prévisions de transits pour l’année sélectionnée	5	5 000	PDF
/v1/reports/relocation	Thème natal, jusqu’à 5 villes, planètes ayant changé de maison, lignes proches, 19 domaines de vie	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna et Nakshatra, positions sidérales, Mahadashas de Vimshottari	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, Teva, dettes identifiées, Upayas	2	5 000	PDF
/v1/reports/gemstone	Recommandation de pierres avec mantras, pierres à ne pas porter, état des grahas	7	5 000	PDF
/v1/reports/human-design	Paramètres clés, centres, canaux	2	5 000	PDF
/v1/reports/muhurta	Jours propices classés pour une activité	4	5 000	PDF
/v1/reports/love	Points clés de l’amour, Grande Triade, aspects	2	5 000	PDF
/v1/reports/career	Points clés de carrière, contexte de personnalité, aspects	2	5 000	PDF
/v1/reports/money	Points financiers clés, maisons, aspects	3	5 000	PDF
/v1/reports/business	Points clés d’affaires, maisons, aspects	2	5 000	PDF
/v1/reports/child	Traits de caractère clés, Grande Triade, planètes	2	5 000	PDF
/v1/reports/stellaforge	Affiche de thème sur une page : planètes, équilibre, aspects clés	1	5 000	PDF
/v1/reports/tarot	Description du tirage et des cartes	2	100	PDF
/v1/reports/vastu	Plan de maison avec mandala, évaluation, découvertes Vastu avec sources et corrections	2	5 000	PDF

Le Tarot coûte cinquante fois moins cher car il n’y a pas d’éphémérides : une page de tirage sans calculs astronomiques.

Profondeur : standard ou extended

/v1/reports/natal (et /v1/reports/generate avec report_type: "natal") accepte depth. standard est le document ci-dessus, 5000 crédits. extended coûte 10000 crédits et ajoute la roue du thème et une section pour chacun des corps du Soleil à Pluton, Chiron et l’Ascendant en signe : douze sections, chacune de deux à quatre pages de texte édité (exemple PDF, 13 pages) provenant du même corpus que celui retourné par /v1/natal-texts. Rien n’est généré à la demande, donc la même carte donne le même document.

Les sections sont disponibles en 20 langues, les langues du site ; depth: "extended" avec une autre langue est rejeté avec un 400, et non rempli avec une autre langue. Les autres types de rapports n’ont pour l’instant qu’une seule profondeur : leurs longues sections n’ont pas encore été écrites.

Un seul chemin au lieu de seize

POST /v1/reports/generate accepte le champ report_type et fait la même chose qu’un chemin séparé. Douze types : natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

Pour le SDK, c’est une méthode au lieu de douze, pour le MCP un outil au lieu de douze. Le prix est le même : un appel via le gestionnaire déduit exactement le même montant qu’un chemin direct.

PDF ou HTML

Par défaut, un PDF et un lien vers celui-ci sont retournés. ?format=html renvoie une page HTML prête à l’emploi directement dans la réponse, sans rendu ni stockage : pratique lorsque tu intègres le rapport dans ta page ou que tu souhaites appliquer ton propre CSS.

Le lien PDF est valide pendant 24 heures. Pour donner au client un lien plus long, ajoute ?retain_days=30 (jusqu’à 90) : le fichier restera pendant ce nombre de jours, et expires_at dans la réponse l’indiquera. Nous n’hébergeons pas indéfiniment des documents tiers, et tu peux supprimer un fichier plus tôt via DELETE /v1/reports/files/{filename}, gratuitement. Le fichier contient ce que tu as envoyé, avec le nom, donc la durée de conservation est décrite dans le DPA, section 2. GET /v1/reports/history affiche gratuitement les dernières exportations de cette clé, et un enregistrement expiré est retourné avec expired: true.

Ta marque, pas la nôtre

whitelabel accepte un objet avec 15 champs : companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing et cinq couleurs (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).

Tu peux le transmettre directement dans la requête, et aucune configuration de compte n’est alors nécessaire :

curl -X POST https://api.astroway.info/v1/reports/natal \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chart": { "date": "1990-05-15", "time": "14:30:00",
                   "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
        "whitelabel": { "companyName": "Zoryana Studio",
                        "reportName": "Your Birth Blueprint",
                        "themeColor": "#7c3aed",
                        "footerText": "zoryana.example" } }'

Dans le document généré, tu trouveras le nom de ton studio, ton propre titre de rapport, la couleur d’accentuation dans les titres de section et ton pied de page. Le mot AstroWay n’y apparaît jamais.

Une alternative pour ceux qui ne veulent pas répéter l’objet dans chaque requête : whitelabel: true utilise la configuration de compte enregistrée. Définis-la sur la page Marque des rapports dans le tableau de bord : nom de l’entreprise, nom du rapport, contacts, logo et deux couleurs, avec un aperçu de l’exemple de rapport natal. Les mêmes paramètres sont disponibles avec la clé via /v1/whitelabel/config et /v1/whitelabel/logo, et POST /v1/whitelabel/preview dessine un exemple en PDF. Un champ transmis dans l’objet a priorité sur le champ enregistré.

Application prête à l’emploi, clonable

Démo en direct et code sur GitHub, MIT.

Table de pratique : données client à gauche, PDF prêt à l’emploi à droite. Chaque tuile de rapport affiche le prix en crédits avant le clic et mène à un exemple prêt. Le white-label est activé par une case à cocher. Le backend est une seule route sans dépendances, car c’est là l’essentiel : le navigateur ne peut pas appeler l’API directement, donc la clé réside sur le serveur.

git clone https://github.com/astroway/starter-practice
cd starter-practice && npm install
cp .env.example .env     # your key goes here
npm run dev

Quatre choses à retenir. Le prix est affiché là où la décision est prise : le serveur renvoie X-Credits-Used à la page, et pas seulement dans le journal. Seize rapports ont quatre formulaires de requête, et non seize. La même requête une deuxième fois coûte zéro, car le cache des réponses renvoie le même fichier. Et ALLOWED_REPORTS limite ce que l’instance acceptera de rendre : la démo publique ne rend que le tirage de Tarot (/v1/reports/tarot, 100 crédits), car une page sur Internet ouverte qui génère un rapport natal (/v1/reports/natal, 5 000) pour n’importe qui épuise le quota mensuel gratuit en deux clics.

Langues

Le champ language accepte 21 codes. Trois sont entièrement traduits : ukrainien, anglais, russe. Pour les dix-huit autres, les noms des signes sont localisés, mais les titres et explications restent en anglais : un rapport allemand écrira “Löwe” sous le titre “Planets”.

Nous le disons clairement, car un rapport est un document que ton client conserve. Le vendre comme étant en allemand, en voyant les noms des signes en allemand dans l’exemple, serait une découverte désagréable pour le client, et non pour nous. Le rapport muhurta est pour l’instant entièrement en anglais.

Attention

Mesuré le 2026-09-20. Si tu as besoin d’une langue spécifique entièrement traduite, écris-nous : la file d’attente des traductions manuelles se fait à la demande, et non par liste.

Combien de rapports par plan

/v1/reports/natal et les autres PDF coûtent 5 000 crédits, donc le quota mensuel du plan se traduit simplement en nombre de rapports :

Plan	Crédits/mois	Rapports PDF	Rapports Tarot
Free	10 000	rapports non disponibles	non disponibles
Indie, $5	50 000	10	500
Starter, $19	200 000	40	2 000
Pro, $59	800 000	160	8 000
Business, $199	3 500 000	700	35 000
Reports Pack, $99	1 500 000	300	15 000

Sur le plan Free, les rapports sont délibérément désactivés : un PDF représente des secondes de travail de Chrome de notre côté, et le tarif gratuit ne les couvre pas. L’entrée la moins chère est l’Indie à 5 $.

Reports Pack est un add-on séparé pour ceux qui n’ont besoin que de rapports : 99 $ par mois, 1 500 000 crédits, soit 300 PDF à 33 cents l’unité, avec white-label. C’est moins cher par PDF que sur Pro, car la clé ne va nulle part ailleurs que dans les rapports. Une clé de ce plan ne fonctionne que pour /v1/reports/* et /v1/whitelabel/*.

Revente de rapports : combien te coûte un PDF

Si tu vends des rapports à tes clients, un seul chiffre compte : combien te coûte un PDF pour ton volume. Dans la limite du plan, c’est le prix du plan divisé par le nombre de PDF. Au-delà de la limite, chaque PDF est considéré comme un dépassement, calculé pour chaque tranche de 10 000 crédits au-delà de la limite, donc un PDF de 5000 crédits coûte la moitié du taux de dépassement du plan.

Plan	PDF inclus	Prix du PDF dans la limite	Chaque PDF au-delà
Indie, $5	10	$0.50	$2.50
Starter, $19	40	$0.48	$2.50
Pro, $59	160	$0.37	$1.50
Reports Pack, $99	300	$0.33	$1.50
Business, $199	700	$0.28	$1.00

Ainsi, le plan le moins cher dépend du nombre de PDF que tu vends par mois, dépassement inclus :

PDF par mois	Plan le moins cher	Tes coûts	Par PDF
10	Indie	$5	$0.50
40	Starter	$19	$0.48
100	Pro	$59	$0.59
160	Pro	$59	$0.37
300	Reports Pack	$99	$0.33
500	Business	$199	$0.40
700	Business	$199	$0.28

Points de bascule : Starter est plus avantageux qu’Indie à partir de 16 PDF, Pro que Starter à partir de 57, Reports Pack que Pro à partir de 187, si tu n’as besoin de rien d’autre que des rapports, Business que Reports Pack à partir de 367. Pro et Business ouvrent également le reste de l’API, Pack uniquement les rapports et le white-label.

Tu fixes ta marge. Pour 300 PDF dans le Reports Pack, tes coûts sont de 99 $ par mois. À 9 $ l’unité, cela représente 2700 $ de revenus contre 99 $ de coûts ; à 19 $, cela fait 5700 $. Nous ne conseillons pas de prix de détail, mais l’arithmétique est la même pour n’importe quel prix : ton prix moins 33 cents.

Le rapport natal étendu coûte deux fois plus cher que le standard, donc sur chaque plan ci-dessus, c’est le double du prix par PDF : 0,66 $ dans le Reports Pack.

Deux choses réduisent encore les coûts réels. Une requête répétée avec les mêmes données renvoie le même fichier depuis le cache des réponses et ne coûte rien, donc un client qui télécharge un rapport deux fois n’est facturé qu’une seule fois. Et un plan annuel, c’est 12 mois pour le prix de 9, et le Reports Pack revient à 0,25 $ par PDF.

Avant de vendre, ouvre les exemples : chacun est exactement le fichier que l’API renvoie, et avec whitelabel, ton nom et tes couleurs remplacent les couleurs par défaut.

Si tu as besoin de texte, pas d’un document

Cinq endpoints renvoient un narratif IA au format JSON, sans mise en page ni PDF : /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. 250 crédits chacun. Utilise-les lorsque le texte est destiné à ta propre mise en page, application ou newsletter.

Le rapport natal prend également en charge un mode mixte : enrich: true ajoute le narratif IA à l’intérieur du PDF. Pour la même carte de test, cela représente 5 pages au lieu de 3.