PDF Report API Launch: Branded Astrology PDFs from a Single Call

What shipped

This replaces what used to be a multi-step process: call the natal API, call the transit API, layout the data in a templating engine, run it through Puppeteer or wkhtmltopdf, hope nothing breaks. The new endpoint does all of that server-side.

What's in V1

• 5 report types — natal, transit, synastry, electional, solar return
• 9 languages for report text — English, Spanish, French, German, Portuguese, Italian, Dutch, Polish, Russian
• Custom branding — pass a logo URL, brand color hex, and custom footer text; everything renders inline
• Configurable depth — short summary (4-6 pages), standard (15-25 pages), or comprehensive (50+ pages)
• Chart graphics included — natal wheel, transit overlay, synastry bi-wheel rendered as embedded SVG inside the PDF
• Sub-five-second generation for standard reports; comprehensive reports under 15 seconds

Why it matters

Professional astrologers who run consulting practices have been asking for this for months. The previous workflow looked like: open Solar Fire on a desktop computer, generate the chart, copy-paste interpretations into a Word doc, export to PDF, email to client. Per-report turnaround: 45 minutes. Per-report cost in astrologer time: $40-80.

With the PDF Report API, that workflow becomes: POST to the endpoint, receive PDF, attach to email. Turnaround: under 10 seconds. Astrologer time per report: zero. Margin per consultation client goes up; volume becomes the constraint instead of time.

The other audience: any app that wants to offer "download your full report" as a premium feature without building PDF generation infrastructure.

How to integrate

1const pdf = await fetch('https://api.astrology-api.io/v1/pdf-report', {
2  method: 'POST',
3  headers: { 'Authorization': `Bearer ${process.env.ASTROLOGY_API_KEY}` },
4  body: JSON.stringify({
5    reportType: 'natal',
6    depth: 'standard',
7    language: 'en',
8    birthData: {
9      date: '1990-04-15',
10      time: '14:30',
11      latitude: 40.7128,
12      longitude: -74.0060,
13    },
14    branding: {
15      logoUrl: 'https://your-brand.com/logo.png',
16      primaryColor: '#8B5CF6',
17      footerText: 'Generated by Your Brand',
18    },
19  }),
20});
21
22// pdf is a binary stream — pipe to disk, S3, or directly to the user
23const buffer = await pdf.arrayBuffer();

Where to learn more

• Product page: /p/pdf-report-api
• Demo: /demo

Pricing

PDF Report generation is available on Professional ($37/mo) and above. Each PDF counts as a single API request regardless of report depth. Comprehensive reports occasionally fall back to a longer-running async mode; you receive a job ID and a webhook fires when the PDF is ready.

What's next

V2 will add a custom-template upload endpoint (bring your own InDesign-derived layout), bulk batching (100 PDFs in one request), and a "white-label PDF only" tier for consulting practices that just want PDF generation without the rest of the API surface.