Astrology Suite for FreeAstroAPI

Astrology Suite for FreeAstroAPI is a WordPress toolkit for publishing interactive astrology without exposing API credentials to visitors. The site owner connects one FreeAstroAPI key, sets the request-per-second limit for that key's current plan, and publishes responsive blocks or shortcodes.

Western astrology

• Render a natal wheel, interpretation report, or combined chart and report.
• Offer focused Sun, Moon, Rising, and Midheaven widgets.
• Publish monthly ephemeris tables with body filters, tropical or sidereal mode, optional local points, and CSV download.
• Add daily sign and personalized horoscope experiences.

Vedic astrology

• Display D1, D9, and other supported vargas in North, South, or East Indian layouts.
• Give astrologers a detailed workbench with grahas, Vimshottari dashas, yogas and doshas, Panchang, Shadbala, Ashtakavarga, Avastha, and practitioner presets.
• Control Vedic chart layout, labels, node type, colors, sizing, titles, and saved defaults from dedicated settings.
• Style Vedic result panels, summary tiles, tables, and badges with an instant no-request preview.

Built for WordPress site owners

• Use Gutenberg blocks or equivalent shortcodes in classic content and templates.
• Keep FreeAstroAPI and Gemini credentials in server-side WordPress settings; visitors never enter or receive the saved keys.
• Respect different FreeAstroAPI plans with a configurable site-wide request queue, short jittered retries, and a safe 1 RPS default.
• Capture birth details with city autocomplete, explicit 24-hour time controls, and an optional browser-local Past inputs list.
• Let Western natal users mark birth time as unknown; exact birth time remains required for Vedic calculations.
• Localize frontend labels and select the natal interpretation response language.
• Choose built-in chart themes, edit chart request bodies, or use a custom chart_config from the FreeAstroAPI Chart Designer.
• Allow public calculations or restrict them to logged-in editors.
• Add a Western/Vedic astrology bot powered by FreeAstroAPI tools and an optional site-owned Gemini API key.

Included blocks:

• astrology-suite/chart-only
• astrology-suite/report-only
• astrology-suite/chart-report
• astrology-suite/simple-sign-sun
• astrology-suite/simple-sign-moon
• astrology-suite/simple-sign-rising
• astrology-suite/simple-sign-midheaven
• astrology-suite/ephemeris
• astrology-suite/daily-horoscope
• astrology-suite/personalized-horoscope
• astrology-suite/vedic-chart
• astrology-suite/vedic-workbench
• astrology-suite/astrology-bot

Included shortcodes:

• [astrology_suite mode="chart-report"]
• [astrology_suite mode="chart-report" language="vi"]
• [astrology_suite_chart_only]
• [astrology_suite_report_only]
• [astrology_suite_chart_report]
• [astrology_suite_simple_sign_sun include_interpretation="true" interpretation_style="improved"]
• [astrology_suite_simple_sign_moon include_interpretation="false"]
• [astrology_suite_simple_sign_rising include_interpretation="true" interpretation_style="poetic"]
• [astrology_suite_simple_sign_midheaven]
• [astrology_suite_ephemeris]
• [astrology_suite_daily_horoscope]
• [astrology_suite_personalized_horoscope]
• [astrology_suite_vedic_chart]
• [astrology_suite_vedic_workbench]
• [astrology_suite_astrology_bot]

External services

Astrology Suite for FreeAstroAPI connects to FreeAstroAPI (https://www.freeastroapi.com/) to autocomplete cities and generate astrology calculations used by the included blocks. The Astrology Bot also connects to Google Gemini to generate chat answers.

What is sent and when:

• When someone types at least two characters into the city field, the plugin sends the typed city query and optional country filter to FreeAstroAPI over HTTPS so matching cities and timezones can be returned.
• When a visitor submits a natal chart, report, simple-sign, ephemeris, horoscope, Vedic chart/workbench, or astrology bot form while public calculations are enabled, or when an authenticated editor submits while public calculations are disabled, the plugin sends the submitted astrology data and calculation options to FreeAstroAPI over HTTPS. This may include the optional name field, birth date, birth time, city name, latitude, longitude, timezone, interpretation settings, selected bodies, zodiac type, Vedic vargas/modules/layout, horoscope dates, chat message/history/profile, the requested calculation mode, and whether minor aspects were requested.
• Astrology bot requests may send the chat message, recent chat history, selected Western/Vedic system, and submitted birth profile to FreeAstroAPI MCP and Google Gemini over HTTPS.
• Calculation requests also include the site's configured FreeAstroAPI key in the server-to-server request header so FreeAstroAPI can authenticate the request. The API key is not sent to the visitor's browser.
• Astrology bot answer requests include the site's configured Gemini API key in the server-to-server request header. The Gemini API key is not sent to the visitor's browser.
• The plugin does not store visitor birth data in WordPress by default. The optional “Past inputs” feature stores recent successful requests only in the visitor's local browser storage.

FreeAstroAPI Terms of Service: https://www.freeastroapi.com/terms FreeAstroAPI Privacy Policy: https://www.freeastroapi.com/privacy FreeAstroAPI Chart Designer: https://www.freeastroapi.com/dashboard/chart-designer FreeAstroAPI Ephemeris Docs: https://www.freeastroapi.com/docs/western/ephemeris FreeAstroAPI Daily Sign Horoscope Docs: https://www.freeastroapi.com/docs/western/daily-sign FreeAstroAPI Daily Personal Horoscope Docs: https://www.freeastroapi.com/docs/western/daily-personal FreeAstroAPI Vedic Visual Chart Docs: https://www.freeastroapi.com/docs/vedic/visual-chart FreeAstroAPI Full Vedic Calculate Docs: https://www.freeastroapi.com/docs/vedic/calculate FreeAstroAPI Western Natal Docs: https://www.freeastroapi.com/docs/western/natal FreeAstroAPI Astrology Bot: https://www.freeastroapi.com/astrology-bot Google Gemini API Key Docs: https://ai.google.dev/gemini-api/docs/api-key