Solar Return PDF API

POSThttps://pdf.astrologyapi.com/v1/solar_return_report/tropical

Copy

The Solar Return API generates PDF horoscope based on the birth details provided in the request data.

The request data also has number of other options such as border style, footer links, lord Ganesha picture style and other last page details. These options can be used to customise the PDF as per your company and brand requirement.

The PDF API in response provides you with a PDF URL from where either your user can download the PDF or you can directly send the PDF horoscope on your user’s email address. The usage of PDF horoscope can be completely customised as per your requirements.

POST/solar_return_report/tropical

Copy

1import requests
2import json
3
4# Your API key
5api_key = "<YOUR_API_KEY>"
6
7# API endpoint URL
8api_url = "https://pdf.astrologyapi.com/v1/solar_return_report/tropical"
9
10# Request data
11data = {
12        "name": 15,
13        "day": 15,
14        "month": 8,
15        "year": 1990,
16        "hour": 10,
17        "minute": 30,
18        "latitude": 39.9526,
19        "longitude": -75.1652,
20        "language": "tropical",
21        "timezone": -5,
22        "place": "tropical",
23        "footer_link": "tropical",
24        "logo_url": "tropical",
25        "company_name": "tropical",
26        "company_info": "tropical",
27        "domain_url": "tropical",
28        "company_email": "tropical",
29        "company_landline": "tropical",
30        "company_mobile": "tropical",
31        "solar_year": 2022
32    }
33
34headers = {
35    'x-astrologyapi-key': api_key,
36    'Content-Type': 'application/json'
37    # Add 'Accept-Language': '<language_code>' if needed
38}
39
40try:
41    response = requests.post(api_url, headers=headers, json=data)
42    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)
43
44    # Process the response
45    response_data = response.json()
46    print(json.dumps(response_data, indent=4))
47
48except requests.exceptions.RequestException as e:
49    print(f"Error making API request: {e}")
50    if hasattr(e, 'response') and e.response is not None:
51        try:
52            print(f"Error response: {e.response.json()}")
53        except json.JSONDecodeError:
54             print(f"Error response (non-JSON): {e.response.text}")
55
56

200Response

Copy

1{
2  "status": true,
3  "pdf_url": "https://s3.amazonaws.com/astrologyapi-pdfs/solar_return_sample.pdf"
4}

Request Headers

Authorization

string

required

Basic Authorization via header

Accept-Language

string

Preferred language for the response content

Properties

English - enPortuguese - ptGerman - deFrench - frSpanish - esItalian - itRussian - ru

Request Parameters

name

string

required

Name of the user, eg: "Ajeet Kanojia"

day

integer

required

Birth day (1-31)

month

integer

required

Birth month (1-12)

year

integer

required

Birth year (e.g., 1990)

hour

integer

required

Birth hour (0-23)

minute

integer

required

Birth minute (0-59)

latitude

float

required

Latitude of birth location

longitude

float

required

Longitude of birth location

language

string

required

Pdf Language eg. en,hi,ma,bn,ta,te,kn,ml

Properties

enhimabntateknml

timezone

float

required

Timezone offset (e.g., -5 for EST)

place

string

required

User birth place , eg: "Mumbai,Maharashtra India"

footer_link

string

required

Your domain link , eg: "astrologyapi.com""

logo_url

string

required

Your company logo url , eg: "logo_url"

company_name

string

required

Your company name , eg: "Vedic Rishi Astro Solutions Pvt. Ltd."

company_info

string

required

NOTE- SHOULD BE LESS THAN 500 CHARACTER , eg: "Your Company Info"

domain_url

string

required

Your domain full url , eg: "https://www.astrologyapi.com"

company_email

string

required

Your company email , eg: "[email protected]"

company_landline

string

required

Your company Landline number , eg: "+91- 221232 22"

company_mobile

string

required

Your company mobile number, eg: "+91 1212 1212 12"

solar_year

integer

required

Solar report year , eg: 2022

The Solar Return PDF Samples

Following are the The Solar Return PDF API samples you can download. These generated PDFs are using AstrologyAPI branding and everything can be customised to suit your company branding and style.

View Sample

English PDF Sample

View Sample

German PDF Sample

View Sample

French PDF Sample

View Sample

Spanish PDF Sample

View Sample

Italian PDF Sample

View Sample

Russian PDF Sample

View Sample

Brazilian Portuguese PDF Sample

Errors

400

Bad Request

Something is wrong with your request format or parameters.

401

Unauthorized

Your API key is missing or invalid.

403

Forbidden

You don't have permission to access this specific resource.

404

Not Found

The API endpoint you're trying to reach doesn't exist.

500

Internal Server Error

Our server is having a temporary glitch.

POST/solar_return_report/tropical

Copy

1import requests
2import json
3
4# Your API key
5api_key = "<YOUR_API_KEY>"
6
7# API endpoint URL
8api_url = "https://pdf.astrologyapi.com/v1/solar_return_report/tropical"
9
10# Request data
11data = {
12        "name": 15,
13        "day": 15,
14        "month": 8,
15        "year": 1990,
16        "hour": 10,
17        "minute": 30,
18        "latitude": 39.9526,
19        "longitude": -75.1652,
20        "language": "tropical",
21        "timezone": -5,
22        "place": "tropical",
23        "footer_link": "tropical",
24        "logo_url": "tropical",
25        "company_name": "tropical",
26        "company_info": "tropical",
27        "domain_url": "tropical",
28        "company_email": "tropical",
29        "company_landline": "tropical",
30        "company_mobile": "tropical",
31        "solar_year": 2022
32    }
33
34headers = {
35    'x-astrologyapi-key': api_key,
36    'Content-Type': 'application/json'
37    # Add 'Accept-Language': '<language_code>' if needed
38}
39
40try:
41    response = requests.post(api_url, headers=headers, json=data)
42    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)
43
44    # Process the response
45    response_data = response.json()
46    print(json.dumps(response_data, indent=4))
47
48except requests.exceptions.RequestException as e:
49    print(f"Error making API request: {e}")
50    if hasattr(e, 'response') and e.response is not None:
51        try:
52            print(f"Error response: {e.response.json()}")
53        except json.JSONDecodeError:
54             print(f"Error response (non-JSON): {e.response.text}")
55
56

200Response

Copy

1{
2  "status": true,
3  "pdf_url": "https://s3.amazonaws.com/astrologyapi-pdfs/solar_return_sample.pdf"
4}