What image formats does Chart Rendering API support?

The API supports five formats: SVG (scalable vector, default), PNG (transparency support), JPEG (email-compatible), WebP (30% smaller than PNG), and PDF (print-ready vector). Choose the format that best fits your use case via a simple API parameter.

Which format works best in email clients like Outlook?

Use JPEG or PNG for email compatibility - they work perfectly in Outlook and all email clients. JPEG is smaller, PNG supports transparency. Avoid SVG and WebP in emails as many clients don't support them. This is critical for astrology apps sending chart reports via email.

How do I customize chart colors for my brand?

Pass custom color parameters to the API: background, text, primary, secondary, aspect_harmony (green aspects), aspect_tension (red aspects), and zodiac_bg_0/zodiac_bg_1 for alternating zodiac sectors. This enables true white-label integration matching any brand identity.

What's the advantage of WebP over PNG?

WebP delivers approximately 30% smaller file sizes than PNG with equivalent visual quality. It supports transparency like PNG. Use WebP for web applications where you control the platform. For email or maximum compatibility, stick with PNG or JPEG.

How do I generate charts for retina/HiDPI displays?

Use the scale parameter: scale=2.0 for standard retina (@2x), scale=3.0 for iPhone Plus models (@3x). Combined with appropriate width, this produces crisp charts on high-density displays. For example: width=540, scale=2.0 creates a 1080px image for retina.

What resolution options are available?

Set width from 100 to 4096 pixels - height is calculated automatically to maintain proportions. Use scale (0.5-4.0x) as a multiplier for HiDPI. For JPEG/WebP, quality (1-100) controls compression. This covers everything from thumbnails to 4K print.

How much does Chart Rendering API cost?

Chart rendering costs 10 credits per request (Ultra plan and above, starting at $37/month for 55,000 credits). This covers the compute-intensive server-side rendering for all five formats and custom colors. Free tier doesn't include chart rendering.

What's the best format for social media sharing?

Use JPEG with width=1080 for Instagram and Facebook - it's the standard size and format. For Twitter, width=1200 works well. JPEG keeps files small for fast loading while maintaining good quality at quality=90 default setting.

Can I generate print-quality charts?

Yes! Use PDF format with scale=2.0 for professional print quality. PDF preserves vector graphics, so charts scale to any print size without quality loss. For raster print, use PNG with width=4096 and scale=2.0 for maximum resolution.

How fast are charts generated?

Charts generate in under 1 second regardless of format or size. Our server-side rendering is optimized for speed with global CDN caching. Most users see response times under 500ms. Complex charts with many aspects take the same time as simple ones.

What color parameters can I customize?

Eight color parameters: background (chart background), text (text and lines), primary/secondary (accent colors), aspect_harmony (harmonious aspects), aspect_tension (tense aspects), and zodiac_bg_0/zodiac_bg_1 (alternating zodiac sector colors). Use hex values like #FF5500.

Is SVG better than PNG for web applications?

SVG is resolution-independent - it scales infinitely without quality loss, perfect for responsive designs. However, SVG files can be larger and require more browser resources to render. For static displays or when you know the size, WebP or PNG may load faster.

What house systems are supported?

We support 23 house systems including Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyry, Topocentric, and many more. Each system is calculated with Swiss Ephemeris precision.

How accurate are the astrological calculations?

We use Swiss Ephemeris, the same astronomical data used by NASA (JPL). This provides sub-arcsecond accuracy for planetary positions. Combined with 23 house systems, charts are as accurate as any professional astrology software.

Can I use the same chart in multiple formats?

Yes! Just make separate API calls with different format parameters. Many apps generate SVG for web display, JPEG for email reports, and PDF for downloadable files - all from the same birth data and color settings.

How do I integrate chart rendering with my app?

It's a simple REST API call - send birth data and rendering options, receive image data or URL. Works with any language: JavaScript, Python, Ruby, PHP. For web, embed SVG directly or use image URLs. Mobile apps typically download PNG/WebP files.

Is there rate limiting on chart generation?

Rate limits depend on your plan. Ultra plan includes 55,000 credits/month (5,500 charts at 10 credits each). Business plan includes 220,000 credits (22,000 charts). Enterprise plans offer unlimited generation with dedicated infrastructure.

What's the difference between this and PDF Reports API?

Chart Rendering API gives you individual chart images in multiple formats. PDF Reports API generates complete multi-page PDF documents with charts, interpretations, and formatted text. Use Chart Rendering for apps needing chart images, PDF Reports for downloadable astrology reports.

5 Output Formats

Chart Rendering API: Any Format, Any Color

Generate professional astrology charts in SVG, PNG, JPEG, WebP, or PDF.

Full color customization for white-label branding. Swiss Ephemeris precision from thumbnail to 4K print resolution.

View Demo

Output Formats

<1s

Generation Time

4K+

Max Resolution

100%

Customizable

2.1M+ charts rendered monthly

Used by 750+ platforms worldwide

Swiss Ephemeris precision guaranteed

Chart Rendering Performance

Professional-grade output in any format

<1s

Generation Time

SVG, PNG, JPG, WebP, PDF

Output Formats

4K+

Max Resolution

Unlimited

Custom Colors

1-100

Quality Control

2.1M+

Monthly Renderings

Complete Chart Rendering Solution

Five formats, unlimited colors, one API

Five Output Formats

Generate charts as SVG, PNG, JPEG, WebP, or PDF - each optimized for its purpose.

Format selection via API parameter with automatic optimization

Full Color Customization

Customize every color: background, text, aspects, and zodiac sectors for white-label branding.

8 color parameters for complete brand control

Email Compatibility

JPEG and PNG outputs work perfectly in Outlook and all email clients.

Optimized encoding for maximum email client support

WebP Optimization

Modern WebP format delivers 30% smaller files than PNG with same quality.

Automatic compression with configurable quality settings

Print-Ready PDF

Vector PDF output for professional publications and print materials.

Scale multiplier for high-DPI print output

Flexible Sizing

From 100px thumbnails to 4096px print-ready images with auto height.

Width 100-4096, scale 0.5-4.0x for retina displays

Quality Control

Fine-tune JPEG and WebP compression from 1-100 quality.

Configurable quality balances file size and visual fidelity

Swiss Ephemeris Precision

NASA-grade astronomical calculations ensure accurate planet placement.

Sub-arcsecond accuracy for all celestial bodies

23 House Systems

Support for Placidus, Whole Sign, Equal, Koch, and 19 more systems.

Accurate cusp calculations for all supported systems

What is Chart Rendering API? Complete Guide

Professional astrology charts in 5 formats with full color customization

Chart Rendering API generates professional astrology charts in five formats: SVG for scalable web graphics, PNG for transparency, JPEG for email compatibility (works in Outlook!), WebP for 30% smaller files, and PDF for print-ready quality. Unlike basic libraries, our API offers full color customization - change background, text, aspect colors, and zodiac sectors to match any brand. Swiss Ephemeris precision ensures accurate planetary positions from thumbnails to 4K resolution.

Which format should I use for my use case?

SVG is perfect for web where charts need to scale - it's resolution-independent.

PNG provides transparency for overlays and universal compatibility.

JPEG works everywhere including Outlook email clients.

WebP is 30% smaller than PNG - ideal for mobile apps with bandwidth constraints.

PDF delivers print-ready vector quality for professional reports and publications.

Many apps use multiple formats: WebP for web, JPEG for email reports, PDF for print.

5 formats for every use case

1 min read

How do custom colors work for white-label branding?

Every color in the chart is customizable via API parameters.

Set your background color, text/lines color, primary and secondary accents, harmony aspect colors (typically green), tension aspect colors (typically red), and alternating zodiac sector backgrounds.

This enables true white-label integration - match your brand exactly without post-processing.

Save color presets for consistent branding across all charts.

Full color control for brand consistency

1 min read

What size and quality options are available?

Control output with width (100-4096 pixels), automatic height calculation, and scale multiplier (0.5-4.0x) for HiDPI/retina displays.

For JPEG and WebP, quality setting (1-100) balances file size and visual fidelity - default is 90.

Use scale=2.0 for retina displays, width=1080 for social media, or PDF with scale=2.0 for professional printing.

SVG output is infinitely scalable with no quality settings needed.

From thumbnails to 4K print resolution

1 min read

Does it work in email clients like Outlook?

Yes! JPEG and PNG formats are specifically optimized for email client compatibility, including Microsoft Outlook which has notoriously strict image requirements.

Many astrology apps use our API to generate charts for email reports - they just work.

WebP and SVG should be avoided in emails due to limited client support.

For email campaigns, use JPEG for smallest files or PNG if you need transparent backgrounds.

Email-safe output for Outlook and all clients

1 min read

Use Cases

Email Reports

JPEG or PNG output that works in Outlook and all email clients

Web Display

SVG or WebP for responsive, fast-loading charts

Social Media

JPEG with width=1080 optimized for Instagram/Facebook

Print Materials

PDF with scale=2.0 for professional publication quality

Retina/HiDPI

PNG with scale=2.0 for crisp mobile displays

White-Label Apps

Custom colors for complete brand consistency

Technical Specifications

Output Formats	SVG, PNG, JPEG, WebP, PDF
Generation Time	<1 second for any format
Width Range	100-4096 pixels (height auto)
Scale Multiplier	0.5-4.0x for HiDPI/retina
Quality Setting	1-100 for JPEG/WebP (default 90)
Custom Colors	Background, text, aspects, zodiac sectors
WebP Savings	30% smaller than PNG
Email Compatibility	JPEG/PNG work in Outlook
House Systems	23 systems supported
Calculation Precision	Swiss Ephemeris (NASA JPL data)
Caching	Global CDN with edge caching
Uptime SLA	99.9% availability guaranteed

Chart Rendering API vs DIY Libraries

Feature	Astrology API	Others
Output Formats	SVG, PNG, JPG, WebP, PDF	Usually SVG only
Custom Colors	Full customization	Limited themes
Email Support	Outlook-compatible	Hit or miss
Max Resolution	4K+ (4096px)	Screen resolution
Retina Support	0.5-4.0x scaling	Manual handling
Print Quality	PDF vector output	Screen-only
Bundle Size	Zero (API call)	100-500KB JavaScript
White-Label	Full brand control	Limited customization

Related Astrology APIs

Natal API

Birth chart calculations powering chart rendering

Transit API

Current planetary positions for dynamic charts

Synastry API

Relationship chart comparisons

PDF Reports API

Complete PDF report generation with charts

API Documentation

Complete technical reference and code examples

Simple, Transparent Pricing

Start free, scale as you grow. No hidden fees, no surprises.

Always Free

Start Free

Perfect for learning, testing, and small personal projects

50 API calls/month

Basic natal charts

5 house systems

Community support

Pro

$11/month

For small apps and personal projects

All basic endpoints
12 house systems
Email support

Best Value

Pro Plus

$21/month

For growing apps and medium traffic

All enhanced endpoints
18 house systems
AI interpretations
Priority email support

Ultra

$37/month

For professional astrology applications

Credit math ↓

All premium endpoints
23 house systems
Advanced AI interpretations
Priority support

High Volume Plans

For enterprise-scale applications

Business

$99/month

For high-volume applications

Credit math ↓

ALL endpoints
White-label ready
Custom AI fine-tuning
Phone support

UNLIMITED

Enterprise

$399+per month

Unlimited requests with dedicated infrastructure

Dedicated server infrastructure
Sub-300ms guaranteed
24/7 dedicated support
99.99% uptime SLA

All plans include comprehensive documentation and SDKs

Questions? Talk to our team

Frequently Asked Questions about Chart Rendering API

Everything about formats, colors, and customization

Related Astrology APIs

Chart Rendering API works best in combination with our other tools. Add

birth chart calculations current planetary positions compatibility analysis complete PDF reports technical documentation

Generate Charts in Any Format, Any Color

Join 750+ platforms using our Chart Rendering API for SVG, PNG, WebP, and PDF astrology graphics

Start Free View Documentation

5 output formats

Full color customization

Email-safe output

Up to 4K resolution

Available on Ultra plan and above