API

• PDF Design
• Transits Horoscope
• Basic Flow
• Generating a Transits Horoscope
• Response
• Astrological Wheel

PDF Design

You can customize the design of the PDF by modifying the template files. To make this process easier, we provide an online editor at https://pdf-editor-v1-admin-ui-6xx.pages.dev/, where you can edit template files and preview the results in real time. The editor also allows you to apply custom CSS for further styling.

On the left side of the editor, you'll find a file browser to select the template file you wish to modify. The content of the selected file will appear in the center, where you can make edits. Once you're done, simply click the Save button at the bottom left corner. Your changes will be saved, and the PDF will automatically reload to reflect the updates. Additionally, the generated code will be copied to your clipboard.

To integrate the updated template with AstroAPI, include the copied code in the encodedTemplate parameter of your API request.

Transits Horoscope

A transit horoscope analyses the movement of current planetary positions (transits) in relation to a transits chart, providing insights into how external cosmic energies influence an individual at a specific time.

In this analysis, we examine the positions of the transiting planets within the houses of the transits chart, as well as the aspects formed between the transiting planets and the transits planets. This approach allows us to identify the cosmic influences affecting you during a specific period, such as the next three, six, or twelve months.

You can also use a transit horoscope to look further into the future, exploring influences up to 15 years ahead, or to reflect on past events, such as the cosmic energies present when you got married, had your first child, or experienced other significant milestones. Each house placement or aspect is accompanied by precise dates, indicating the timeframe during which the influence occurs.

For accuracy, we use a narrow orb of 0 to 2.6 degrees for aspects in the transit horoscope. This ensures a highly precise interpretation, tailored to the specific event or timeframe you wish to analyse.

Basic Flow

To generate a Transits Horoscope PDF report from the AstroAPI, the system (your implementation) makes a POST-request to the /api/transits-pdf-report endpoint with the necessary parameters. With correct parameters the AstroAPI will provide a full transits horoscope in PDF format.

Generating a Transits Horoscope

GET /api/transits-pdf-report

Query params

{
    "name_1": "Matthias",
    "date_1": "1984-03-27",
    "time_1": "13:13",
    "place_id_1": 1250015082,

    "name_2": "Wedding",
    "date_2": "2025-08-28",
    "time_2": "10:00",
    "place_id_2": 1840034016,
    "lang": "en",
    "system": "p",
    "planets": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9],
    "collect_text": true,
    "showLogo": true,
    "showNotes": true,
    "showEndAstroapiPage": true,
    "translations": {
      "Name:": "Naam:",
      "Date:": "Datum:"
    },
    "token": "your-access-token"
}

Example: /api/transits-pdf-report?name=Matthias&date=1984-03-27&time=13:13&place_id=3&planets[]=0&planets[]=1&planets[]=2&planets[]=3&token=your-access-token

Params explanation