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-onlyastrology-suite/report-onlyastrology-suite/chart-reportastrology-suite/simple-sign-sunastrology-suite/simple-sign-moonastrology-suite/simple-sign-risingastrology-suite/simple-sign-midheavenastrology-suite/ephemerisastrology-suite/daily-horoscopeastrology-suite/personalized-horoscopeastrology-suite/vedic-chartastrology-suite/vedic-workbenchastrology-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
Screenshots
Frontend chart and report widget with saved birth input, generated natal wheel, and styled form controls.
Frontend natal report sections with Ascendant, Midheaven, and planet interpretation cards.
Frontend aspect dynamics table rendered below the report.
API settings screen with the FreeAstroAPI key field and service disclosure.
Report settings screen for report length, tables, angles, and chart print controls.
Style settings screen for colors, background transparency, border radius, typography, labels, and form controls.
Frontend Vedic Visual Chart with generated D1 Rashi and D9 Navamsha charts.
Vedic Chart settings with a generated D1/D9 settings preview.
Style settings with the instant no-request Vedic result preview.
Vedic Astrology Workbench with overview cards and a readable graha table.