POST

Horoscope Chart SVG Image Code

Generate beautiful, customizable horoscope charts in SVG format using birth date, time, and geographical details. Choose between North Indian and South Indian chart styles, support multiple languages, and customize fonts, colors, borders, and chart display settings.

/horoscope-chart-svg-code

Method

POST

Format

JSON

Auth

API Key

Credits

Overview

The Horoscope Chart SVG API generates horoscope charts in scalable vector graphics (SVG) format using an individual's birth date, time, latitude, longitude, and timezone. The generated chart can be embedded directly into websites, mobile applications, and astrology software without requiring a separate chart-rendering library.

The API supports both North Indian and South Indian chart layouts. Developers can customize the chart appearance using options for font family, font sizes, background color, border color, planet name colors, chart heading, and native details. You can also choose whether to display birth time and location information or outer planets on the chart.

The API supports multiple languages, including English, Telugu, Hindi, Tamil, Kannada, Malayalam, and other Indian languages. Additional configuration options allow you to select the Ayanamsha system and choose between geocentric and topocentric planetary positions.

The response contains the generated SVG markup in the output field. You can use this SVG code directly in your application, save it as an SVG file, or embed it into an HTML page to display a high-quality, scalable horoscope chart.

Request Parameters

Parameter	Type	Required	Description	Example
`year`	integer	Yes	Year number, eg: 2023	2023
`month`	integer	Yes	Month number,with no leading zero	7
`date`	integer	Yes	Day number,with no leading zero	5
`hours`	integer	Yes	Hours number,with no leading zero	1
`minutes`	integer	Yes	Minutes number,with no leading zero	1
`seconds`	integer	Yes	Seconds number, with no leading zero	0
`latitude`	float	Yes	Latitude number, in the range from -90 to 90	12.86
`longitude`	float	Yes	Longitude number, in the range from -180 to 180	123.5
`timezone`	float	Yes	Timezone of birth location, eg: 5.5	5.5
📦 `config`	object	No	Contains optional configuration values
`ayanamsha`	string	No	Either "tropical" or "sayana" or "lahiri"	Either "tropical" or "sayana" or "lahiri"
`language`	string	No	Valid 2 letter ISO 639-1 language code	Either "en" For English or "te" for Telugu or "hi" for Hindi or "ta" for Tamil or "kn" for Kannada or "ml" for Malayalam or "or" for Odia or "gu" for Gujarati or "pa" for Punjabi or "bn" for Bengali or "mr" for Marathi or "as" for Assamese or "ur" for Urdu or "ne" for Nepali
`observation_point`	string	No	Geocentric positions are calculated with respect to the center of Earth. Topocentric positions are calculated with respect to the actual given place	Either "topocentric" or "geocentric"
📦 `chart_config`	object	No	Configuration properties of Chart
`font_family`	string	No	Font name	Mallana or Roboto
`hide_time_location`	boolean	No	Whether to write or hide Time and Location information on chart	"True" or "False"
`hide_outer_planets`	boolean	No	Whether to hide Outer Planets or not	"True" or "False"
`chart_style`	string	No	Chart Style	"south_india" or "north_india"
`sign_number_font_color`	string	No	HEX color code to be used for Sign Numbers (works for north_india chart only)	#A5243D
`native_name`	string	No	Native Name	Mr Ram Charan
`native_name_font_size`	string	No	Font Size to be used to show Native Name	20px
`native_details_font_size`	string	No	Font size to be used to print Native Details	22px
`chart_border_width`	integer	No	Border width of Chart	1
`planet_name_font_size`	string	No	Font size to be used to show Planet names	22px
`chart_heading_font_size`	string	No	Font Size to be used to show Chart Heading	25px
`chart_background_color`	string	No	HEX color code to be used for Chart Background	#FEE1C7
`chart_border_color`	string	No	HEX color code to be used for chart borders	#B5A886
`native_details_font_color`	string	No	HEX color code to be used to show Native details	#000000
`native_name_font_color`	string	No	HEX color code to be uses to show native name	#231F20
`planet_name_font_color`	string	No	HEX color code to be used tp show Planet names	#BC412B
`chart_heading_font_color`	string	No	HEX color code to be used to show Chart Heading	#2D3319

Supported Languages

This API endpoint supports the following languages. Use the corresponding 2-letter language code in the language parameter when making your request.

Language	Code
English	`en`
Telugu	`te`
Hindi	`hi`
Tamil	`ta`
Kannada	`kn`
Malayalam	`ml`
Odia	`or`
Gujarati	`gu`
Punjabi	`pa`
Bengali	`bn`
Marathi	`mr`
Assamese	`as`
Urdu	`ur`
Nepali	`ne`

Example

To request the response in Telugu, use te as the language code:

{
    "language": "te"
}

Request Example

{
    "year": 2024,
    "month": 1,
    "date": 1,
    "hours": 10,
    "minutes": 30,
    "seconds": 31,
    "latitude": 17.38333,
    "longitude": 78.4666,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric / topocentric */
        "ayanamsha": "lahiri", /* lahiri / sayana */
        "language":"te" /* en / te / hi / ta / kn / ml / or / gu / pa / bn / mr / as / ur / ne   */
    },
    "chart_config" :  {
            "font_family":"Mallanna", /* Mallanna / Roboto */
            "hide_time_location":"False", /* True / False */
            "hide_outer_planets":"False", /* True / False */
            "chart_style":"south_india",  /* south_india / north_india */
            "sign_number_font_color":"#A5243D",/* works for north_india chart only */
            "native_name":"Mr. Ram Charan",
            "native_name_font_size": "20px",
            "native_details_font_size":"15px",
            "chart_border_width":1,
            "planet_name_font_size": "20px",
            "chart_heading_font_size":"25px",            
            "chart_background_color":"#FEE1C7",            
            "chart_border_color":"#B5A886",            
            "native_details_font_color":"#000",            
            "native_name_font_color": "#231F20",            
            "planet_name_font_color": "#BC412B",            
            "chart_heading_font_color":"#2D3319"
        }
}

Response Examples

Example responses returned by this API.

English Response

{
    "statusCode": 200,
    "output": "<svg width=\"400\" height=\"400\" xmlns=\"http://www.w3.org/2000/svg\"><defs><style>@import url('https://fonts.googleapis.com/css2?family=Mallanna&amp;display=swap');</style></defs><g><rect stroke=\"#B5A886\"  height=\"400\" width=\"400\" y=\"0\" x=\"0\" stroke-width=\"2\" fill=\"#FEE1C7\"/><line stroke-linecap=\"undefined\" stroke-linejoin=\"undefined\"  y2=\"400\" x2=\"100\" y1=\"0\" x1=\"100\" stroke-width=\"1\" stroke=\"#B5A886\" fill=\"none\"/><line stroke-linecap=\"null\" stroke-linejoin=\"null\"  y2=\"400\" x2=\"300\" y1=\"0\" x1=\"300\" fill-opacity=\"null\" stroke-opacity=\"null\" stroke-width=\"1\" stroke=\"#B5A886\" fill=\"none\"/><line stroke-linecap=\"null\" stroke-linejoin=\"null\" y2=\"100\" x2=\"400\" y1=\"100\" x1=\"0\" fill-opacity=\"null\" stroke-opacity=\"null\" stroke-width=\"1\" stroke=\"#B5A886\" fill=\"none\"/><line stroke=\"#B5A886\" stroke-linecap=\"null\" stroke-linejoin=\"null\" y2=\"300\" x2=\"400\" y1=\"300\" x1=\"0\" fill-opacity=\"null\" stroke-opacity=\"null\" stroke-width=\"1\" fill=\"none\"/><line stroke=\"#B5A886\" stroke-linecap=\"null\" stroke-linejoin=\"null\" y2=\"100\" x2=\"200\" y1=\"0\" x1=\"200\" fill-opacity=\"null\" stroke-opacity=\"null\" stroke-width=\"1\" fill=\"none\"/><line stroke-linecap=\"null\" stroke-linejoin=\"null\" y2=\"200\" x2=\"100\" y1=\"200\" x1=\"0\" fill-opacity=\"null\" stroke-opacity=\"null\" stroke-width=\"1\" stroke=\"#B5A886\" fill=\"none\"/><line stroke-linecap=\"null\" stroke-linejoin=\"null\" y2=\"200\" x2=\"300\" y1=\"200\" x1=\"400\" fill-opacity=\"null\" stroke-opacity=\"null\" stroke-width=\"1\" stroke=\"#B5A886\" fill=\"none\"/><line stroke-linecap=\"null\" stroke-linejoin=\"null\" y2=\"400\" x2=\"200\" y1=\"300\" x1=\"200\" fill-opacity=\"null\" stroke-opacity=\"null\" stroke-width=\"1\" stroke=\"#B5A886\" fill=\"none\"/><text font-size=\"20px\"  x=\"140\" y=\"45\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Ju</text><text font-size=\"20px\"  x=\"170\" y=\"70\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">(Ur)</text><text font-size=\"20px\"  x=\"340\" y=\"245\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Mo</text><text font-size=\"20px\"  x=\"340\" y=\"345\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Ke</text><text font-size=\"20px\"  x=\"140\" y=\"345\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">(Me)</text><text font-size=\"20px\"  x=\"170\" y=\"370\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Ve</text><text font-size=\"20px\"  x=\"40\" y=\"345\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Su</text><text font-size=\"20px\"  x=\"70\" y=\"370\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Ma</text><text font-size=\"20px\"  x=\"40\" y=\"245\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Pl</text><text font-size=\"20px\"  x=\"40\" y=\"145\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Asc</text><text font-size=\"20px\"  x=\"70\" y=\"170\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Sa</text><text font-size=\"20px\"  x=\"40\" y=\"45\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Ra</text><text font-size=\"20px\"  x=\"70\" y=\"70\" style=\"fill:#BC412B;\"  font-family=\"'Mallanna', sans-serif\">Ne</text><text  font-family=\"'Mallanna', sans-serif\" font-size=\"25px\" style=\"fill:#2D3319;\" x=\"50%\" y=\"30%\" dominant-baseline=\"middle\" text-anchor=\"middle\">Rasi Chart</text><text  font-family=\"'Mallanna', sans-serif\" font-size=\"20px\" style=\"fill:#231F20;\" x=\"50%\" y=\"50%\" dominant-baseline=\"middle\" text-anchor=\"middle\">Mr. Ram Charan</text><text  font-family=\"'Mallanna', sans-serif\" font-size=\"15px\" style=\"fill:#000;\" x=\"50%\" y=\"60%\" dominant-baseline=\"middle\" text-anchor=\"middle\">Jan 1, 2024</text><text  font-family=\"'Mallanna', sans-serif\" font-size=\"15px\" style=\"fill:#000;\" x=\"50%\" y=\"65%\" dominant-baseline=\"middle\" text-anchor=\"middle\">10:30:31 (5:30 EAST)</text><text  font-family=\"'Mallanna', sans-serif\" font-size=\"15px\" style=\"fill:#000;\" x=\"50%\" y=\"70%\" dominant-baseline=\"middle\" text-anchor=\"middle\">78 E 28, 17 N 23</text></g></svg>"
}

Chart Examples

See how this API can generate beautiful SVG charts in different languages.

English South India Chart

SVG Chart Telugu

English North India

SVG Chart Telugu

Telugu South India

SVG Chart Telugu

Code Examples

Use the following examples to integrate this API into your application.

Python Code

import requests
import json

url = "https://json.freeastrologyapi.com/horoscope-chart-svg-code"

payload = json.dumps({
  "year": 2024,
  "month": 1,
  "date": 1,
  "hours": 10,
  "minutes": 30,
  "seconds": 31,
  "latitude": 17.38333,
  "longitude": 78.4666,
  "timezone": 5.5,
  "config": {
    "observation_point": "topocentric",
    "ayanamsha": "lahiri",
    "language": "en"
  },
  "chart_config": {
    "font_family": "Mallanna",
    "hide_time_location": "False",
    "hide_outer_planets": "False",
    "chart_style": "south_india",
    "sign_number_font_color": "#A5243D",
    "native_name": "Mr. Ram Charan",
    "native_name_font_size": "22px",
    "native_details_font_size": "22px",
    "planet_name_font_size": "20px",
    "chart_heading_font_size": "22px",
    "chart_background_color": "#EFE7DD",
    "chart_border_color": "#A08772",
    "chart_border_width": 1,
    "native_details_font_color": "#6E6259",
    "native_name_font_color": "#A08772",
    "planet_name_font_color": "#9C3D3D",
    "chart_heading_font_color": "#A08772"
  }
})
headers = {
  'Content-Type': 'application/json',
  'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

PHP Code

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/horoscope-chart-svg-code',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "year": 2024,
    "month": 1,
    "date": 1,
    "hours": 10,
    "minutes": 30,
    "seconds": 31,
    "latitude": 17.38333,
    "longitude": 78.4666,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", 
        "ayanamsha": "lahiri", 
        "language": "en" 
    },
    "chart_config": {
        "font_family": "Mallanna",
        "hide_time_location": "False",
        "hide_outer_planets": "False",
        "chart_style": "south_india",
        "sign_number_font_color": "#A5243D",
        "native_name": "Mr. Ram Charan",
        "native_name_font_size": "22px",
        "native_details_font_size": "22px",
        "planet_name_font_size": "20px",
        "chart_heading_font_size": "22px",
        "chart_background_color": "#EFE7DD",
        "chart_border_color": "#A08772",
        "chart_border_width": 1,
        "native_details_font_color": "#6E6259",
        "native_name_font_color": "#A08772",
        "planet_name_font_color": "#9C3D3D",
        "chart_heading_font_color": "#A08772"
    }
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'x-api-key: YOUR_API_KEY_HERE'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Node JS Code

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/horoscope-chart-svg-code',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 2024,
    "month": 1,
    "date": 1,
    "hours": 10,
    "minutes": 30,
    "seconds": 31,
    "latitude": 17.38333,
    "longitude": 78.4666,
    "timezone": 5.5,
    "config": {
      "observation_point": "topocentric",
      "ayanamsha": "lahiri",
      "language": "en"
    },
    "chart_config": {
      "font_family": "Mallanna",
      "hide_time_location": "False",
      "hide_outer_planets": "False",
      "chart_style": "south_india",
      "sign_number_font_color": "#A5243D",
      "native_name": "Mr. Ram Charan",
      "native_name_font_size": "22px",
      "native_details_font_size": "22px",
      "planet_name_font_size": "20px",
      "chart_heading_font_size": "22px",
      "chart_background_color": "#EFE7DD",
      "chart_border_color": "#A08772",
      "chart_border_width": 1,
      "native_details_font_color": "#6E6259",
      "native_name_font_color": "#A08772",
      "planet_name_font_color": "#9C3D3D",
      "chart_heading_font_color": "#A08772"
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});