PDF customization

Here's everything you can customize in our PDF reports. All options go inside the pdf_options object in your request JSON.

Customization system

Themes

Choose from 3 built-in visual themes via pdf_options.style.theme:

"pdf_options": {
  "style": { "theme": "dark" }
}

Language

17 languages supported via pdf_options.language:

en, de, fr, es, pt, it, nl, pl, ru, uk, zh, ja, ko, hi, ar, he, tr

"pdf_options": { "language": "pt" }

White-Label Branding

Remove all Astrology API references and replace with your own brand. Pass a branding object inside pdf_options:

"pdf_options": {
  "branding": {
    "logo_url": "https://yoursite.com/logo.png",
    "logo_position": "left",
    "logo_max_height": 40,
    "company_name": "Estrelas & Destino",
    "company_website": "https://estrelasedestino.com.br",
    "company_tagline": "Sua jornada cosmica comeca aqui",
    "primary_brand_color": "#7C3AED",
    "secondary_brand_color": "#A78BFA",
    "footer_disclaimer": "For entertainment purposes only."
  }
}

Advanced Customization (CSS & HTML)

For full control, use the customization object inside pdf_options:

"pdf_options": {
  "customization": {
    "custom_css": "h1 { color: #1E40AF; } .section-title { border-bottom: 2px solid #6366F1; }",
    "custom_header_html": "<div>{{company_name}} | {{generation_date}}</div>",
    "custom_footer_html": "<div>{{company_name}} | {{website}}</div>",
    "custom_cover_html": "<div class='custom-cover'><h1>{{report_title}}</h1><p>Prepared for {{subject_name}}</p><p>Born: {{birth_date}}</p></div>",
    "inject_before_content": "<div class='intro'>This report was prepared for {{subject_name}}.</div>",
    "inject_after_content": "<div class='outro'>Thank you for choosing {{company_name}}!</div>"
  }
}

Available placeholders in all custom HTML:

Content Sections — What to show or hide

Each report type has toggleable sections. Set any to false to remove it from the PDF.

Daily Horoscope Sections

"sections": {
  "general_overview": true,
  "love_relationships": true,
  "career_finance": true,
  "health_wellness": true,
  "lucky_elements": true,
  "daily_affirmation": true,
  "planetary_influences": true,
  "max_planetary_influences": 5,
  "moon_phase": true,
  "retrograde_watch": false,
  "fixed_stars": false
}

max_planetary_influences controls how many transit details to show (1–10, default 5).

retrograde_watch and fixed_stars are off by default — enable them for advanced astrology audiences.

Weekly Horoscope Sections

"sections": {
  "header": true,
  "overall_theme": true,
  "energy_timeline": true,
  "key_days": true,
  "moon_phases": true,
  "life_areas": true,
  "career": true,
  "love": true,
  "finances": true,
  "health": true,
  "personal_growth": true,
  "spiritual": true,
  "planetary_influences": true,
  "max_planetary_influences": 10,
  "aspect_calendar": true,
  "houses_in_focus": true,
  "lucky_elements": true,
  "weekly_advice": true,
  "week_summary": true,
  "affirmation": false,
  "retrograde_watch": false,
  "fixed_stars": false
}

Natal Report Sections

"sections": {
  "cover_page": true,
  "how_to_read": true,
  "chart_wheel": true,
  "chart_overview": true,
  "big_three_summary": true,

  "sun_analysis": true,
  "moon_analysis": true,
  "ascendant_analysis": true,
  "midheaven_analysis": true,

  "mercury_analysis": true,
  "venus_analysis": true,
  "mars_analysis": true,
  "jupiter_analysis": true,
  "saturn_analysis": true,

  "houses_analysis": true,
  "major_aspects": true,
  "aspect_patterns": true,

  "life_themes": true,
  "strengths_challenges": true,
  "life_purpose": true,
  "technical_tables": true
}

Interpretation Tradition (Natal only)

Choose the interpretation style via the tradition field:

{
  "subject": { ... },
  "tradition": "psychological"
}

House System (Natal only)

Set via chart_options.house_system:

{
  "subject": { ... },
  "chart_options": { "house_system": "W" }
}

Chart Visualization (Natal only)

Example: Branded Weekly Horoscope

{
  "sign": "Sco",
  "week_start": "2026-02-16",
  "sections": {
    "retrograde_watch": true,
    "affirmation": true,
    "fixed_stars": true
  },
  "pdf_options": {
    "language": "pt",
    "style": { "theme": "dark" },
    "branding": {
      "logo_url": "https://yoursite.com/logo.png",
      "company_name": "Estrelas & Destino",
      "company_website": "https://estrelasedestino.com.br",
      "primary_brand_color": "#7C3AED"
    }
  }
}

Example: Natal Report in Google corporate style

Request

{
  "subject": {
    "name": "Sundar Pichai",
    "birth_data": {
      "year": 1972, "month": 6, "day": 10,
      "hour": 12, "minute": 0,
      "city": "Madurai", "country_code": "IN"
    }
  },
  "pdf_options": {
    "style": {
      "theme": "minimal",
      "accent_color": "#4285F4",
      "secondary_color": "#34A853",
      "font_style": "modern",
      "font_size_base": 11,
      "line_height": 1.6
    },
    "page_settings": {
      "page_size": "A4",
      "margins": { "top": 22, "bottom": 22, "left": 20, "right": 20 }
    },
    "header_footer": {
      "show_header": true,
      "show_footer": true,
      "page_numbers": true,
      "page_number_position": "right",
      "first_page_header": false,
      "first_page_footer": false
    },
    "branding": {
      "company_name": "Google Astrology",
      "company_website": "https://astrology.google.com",
      "company_tagline": "Explore the stars with Google",
      "logo_url": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
      "logo_position": "center",
      "logo_max_height": 50,
      "primary_brand_color": "#4285F4",
      "secondary_brand_color": "#34A853",
      "footer_disclaimer": "Powered by Google Astrology · Confidential"
    },
    "watermark_text": "GOOGLE"
  },
  "sections": {
    "uranus_analysis": false,
    "neptune_analysis": false,
    "pluto_analysis": false,
    "chiron_analysis": false,
    "nodes_analysis": true
  },
  "tradition": "psychological"
}

Result — 42-page branded report