Reports API - 16 report PDF pronti con il tuo brand

Invii una data di nascita, ricevi un documento finito. Non un JSON da cui impaginare un PDF, ma il PDF stesso: impaginato pagina per pagina, con il tuo logo, il tuo titolo del report e senza alcuna menzione di noi all’interno.

Sedici report di questo tipo sono già attivi. Insieme al dispatcher, alla cronologia delle esportazioni e a cinque narrazioni AI sono 23 percorsi sotto /v1/reports/*.

Catalogo

Ogni riga ha un campione pronto. Non è un mockup: il file è generato con la stessa chiamata stampata nella reference di questo endpoint, e viene rigenerato insieme ai template.

Il numero di pagine è quello prodotto da questo specifico campione, misurato il 2026-09-21. Varia con la carta: più aspetti significano più righe, e relocation aggiunge due o tre pagine per ogni città (4 pagine per una città, 13 per cinque).

Endpoint	Cosa contiene	Pagine	Crediti	Campione
/v1/reports/natal	Big Three, pianeti, case, aspetti	3	5 000	PDF
/v1/reports/synastry	Aspetti incrociati tra due carte, equilibrio degli elementi	2	5 000	PDF
/v1/reports/transit-yearly	Previsione dei transiti per l’anno scelto	5	5 000	PDF
/v1/reports/relocation	Carta di partenza, fino a 5 città, pianeti che hanno cambiato casa, linee vicine, 19 ambiti di vita	6	5 000	PDF
/v1/reports/vedic-kundli	Lagna e nakshatra, posizioni siderali, mahadasha Vimshottari	2	5 000	PDF
/v1/reports/lal-kitab	Kismat, teva, rin individuati, upay	2	5 000	PDF
/v1/reports/gemstone	Raccomandazione delle gemme con mantra, gemme da non indossare, stato dei graha	7	5 000	PDF
/v1/reports/human-design	Parametri chiave, centri, canali	2	5 000	PDF
/v1/reports/muhurta	Giorni favorevoli ordinati per una singola attività	4	5 000	PDF
/v1/reports/love	Punti chiave dell’amore, Big Three, aspetti	2	5 000	PDF
/v1/reports/career	Punti chiave della carriera, contesto della personalità, aspetti	2	5 000	PDF
/v1/reports/money	Punti finanziari chiave, case, aspetti	3	5 000	PDF
/v1/reports/business	Punti chiave del business, case, aspetti	2	5 000	PDF
/v1/reports/child	Tratti chiave del carattere, Big Three, pianeti	2	5 000	PDF
/v1/reports/stellaforge	Poster della carta su una pagina: pianeti, equilibrio, aspetti chiave	1	5 000	PDF
/v1/reports/tarot	Descrizione della stesa e delle carte	2	100	PDF

I tarocchi costano cinquanta volte meno perché lì non ci sono effemeridi: una pagina di stesa senza calcoli astronomici.

Un solo percorso invece di sedici

POST /v1/reports/generate accetta il campo report_type e fa la stessa cosa del percorso dedicato. Dodici tipi: natal, transit-yearly, synastry, business, career, love, money, child, lal-kitab, human-design, tarot, vedic-kundli.

Per un SDK è un metodo invece di dodici, per MCP uno strumento invece di dodici. Il prezzo è lo stesso: una chiamata tramite il dispatcher addebita esattamente quanto il percorso diretto.

PDF o HTML

Di default arriva un PDF con il suo link. ?format=html restituisce una pagina HTML pronta direttamente nella risposta, senza rendering e senza archiviazione: comodo quando incorpori il report nella tua pagina o vuoi applicare un tuo CSS.

Il link al PDF vive 24 ore. È voluto: non ospitiamo documenti altrui a tempo indeterminato. Scarica il file subito dopo la risposta. GET /v1/reports/history mostra gratuitamente le ultime esportazioni di questa chiave, e una voce scaduta arriva con expired: true.

Il tuo brand, non il nostro

whitelabel accetta un oggetto di 15 campi: companyName, companyUrl, companyEmail, companyMobile, companyBio, logoUrl, frontImage, reportName, footerText, fontPairing e cinque colori (themeColor, headingColor, textPrimaryColor, textSecondaryColor, backgroundColor).

Puoi passarlo direttamente nella richiesta, e allora non serve alcuna configurazione dell’account:

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" } }'

Nel documento generato ci sono il nome dello studio, il titolo personalizzato del report, il colore d’accento nei titoli delle sezioni e il tuo piè di pagina. La parola AstroWay non compare nemmeno una volta.

Un’alternativa per chi non vuole ripetere l’oggetto in ogni richiesta: whitelabel: true prende la configurazione salvata dell’account (/v1/whitelabel/config), e POST /v1/whitelabel/preview disegna con essa un campione di report natale, per vederlo prima di mostrarlo al cliente.

Un’app pronta da clonare

Demo dal vivo e codice su GitHub, MIT.

La scrivania del professionista: dati del cliente a sinistra, PDF pronto a destra. Ogni riquadro del report mostra il prezzo in crediti prima del clic e porta a un campione pronto. Il white-label si attiva con una spunta. Il backend è una sola rotta senza dipendenze, perché il punto è proprio lì: il browser non può chiamare l’API direttamente, quindi la chiave vive sul server.

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

Quattro cose che vale la pena portarsi via. Il prezzo è mostrato dove si prende la decisione: il server rimanda X-Credits-Used alla pagina, non solo al log. Sedici report hanno quattro forme di richiesta, non sedici. La stessa richiesta ripetuta costa zero, perché la cache delle risposte restituisce lo stesso file. E ALLOWED_REPORTS limita cosa l’istanza accetta di renderizzare: la demo pubblica renderizza solo la stesa dei Tarocchi (/v1/reports/tarot, 100 crediti), perché una pagina aperta su internet che produce un report natale (/v1/reports/natal, 5 000) per chiunque consuma il limite gratuito mensile in due clic.

Lingue

Il campo language accetta 21 codici. Completamente tradotte sono tre: ucraino, inglese, russo. Per le altre diciotto vengono localizzati i nomi dei segni, mentre titoli e spiegazioni restano in inglese: un report tedesco scriverà “Löwe” sotto il titolo “Planets”.

Lo diciamo chiaramente, perché un report è un documento che il tuo cliente conserva. Venderlo come tedesco dopo aver visto i nomi dei segni in tedesco nell’esempio sarebbe una scoperta spiacevole dalla parte del cliente, non dalla nostra. Il report muhurta per ora è interamente in inglese.

Attenzione

Misurato il 2026-09-20. Se ti serve una lingua specifica completa, scrivici: la coda delle traduzioni manuali segue la domanda, non un elenco.

Quanti report si ottengono con un piano

/v1/reports/natal e gli altri PDF costano 5 000 crediti, quindi il limite mensile del piano si converte facilmente in numero di report:

Piano	Crediti/mese	Report PDF	Report Tarocchi
Free	10 000	report non disponibili	non disponibili
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	500 000	100	5 000

Su Free i report sono chiusi di proposito: un PDF sono secondi di lavoro di Chrome dalla nostra parte, e il piano gratuito non li copre. L’ingresso più economico è Indie a $5.

Reports Pack è un add-on separato per chi ha bisogno solo dei report: $99 al mese, 500 000 crediti, cioè 100 PDF a 99 centesimi l’uno, con white-label. Una chiave di questo piano accede solo a /v1/reports/* e /v1/whitelabel/*.

Se ti serve il testo, non il documento

Cinque endpoint restituiscono una narrazione AI in JSON, senza impaginazione né PDF: /v1/reports/ai/natal-narrative, /transit-narrative, /synastry-narrative, /year-ahead-narrative, /monthly-narrative. 250 crediti ciascuno. Usali quando il testo va nel tuo layout, nella tua app o nella tua newsletter.

Il report natale supporta anche una modalità mista: enrich: true aggiunge la narrazione AI all’interno del PDF. Sulla stessa carta di prova sono 5 pagine invece di 3.