RoxyAPI
Quick StartPlaygroundSDKMCP SetupFree TemplatesAGENTS.md
  1. Docs
  3. Integrations
  5. WordPress

WordPress Astrology Plugin

See More

Add daily horoscopes, natal charts, Vedic kundli, tarot, numerology, and more to any WordPress site with Gutenberg blocks and shortcodes. Free to start, no code required.

The official RoxyAPI plugin turns WordPress into a full astrology and spiritual-insight site. 12+ domains, one API key, rendered as interactive blocks and shortcodes that match your theme. WordPress powers about 40 percent of the web, so this is the fastest way to put accurate astrology, tarot, numerology, and Vedic readings in front of real visitors.

Install the plugin

Install from WordPress.org
  1. In your WordPress admin go to Plugins, Add New.
  2. Search for RoxyAPI.
  3. Click Install Now, then Activate.
  4. That is it. The plugin opens the Shortcodes library so you can drop a reading on a page right away.

Prefer the latest unreleased build? Download roxyapi.zip from GitHub Releases and upload it via Plugins, Add New, Upload Plugin. Source: github.com/RoxyAPI/sdk-wordpress.

What the plugin supports

  • 12+ domains, one key. Western astrology, Vedic astrology, daily and weekly and monthly horoscopes, numerology, tarot, human design, forecasts, biorhythm, I Ching, crystals, dream interpretation, and angel numbers. 164+ endpoints, no per-domain fees.
  • Blocks and shortcodes for every reading. Insert a RoxyAPI block in the editor, or paste a shortcode into any post, page, or widget.
  • Interactive charts and cards. Natal wheels, Vedic kundli (North, South, and East Indian styles), KP charts, dasha timelines, panchang tables, human design bodygraphs, astrocartography world maps, forecast timelines, tarot spreads, and biorhythm graphs render as crisp SVG that follows your light or dark theme automatically.
  • Free to start. A small free daily allowance renders readings with no API key, so the plugin works the moment you activate it. Add a key from a RoxyAPI plan when you go live to remove the daily limit.
  • Visitor forms built in. Drop a shortcode with no attributes and the plugin renders an accessible form with a city search. Your visitor enters their own birth details, and the reading appears on the same page.
  • Eight languages. English, German, Hindi, Spanish, Turkish, Portuguese, French, and Russian, switchable with one setting.
  • Key stays server side. Your API key never reaches the browser and is encrypted at rest. Readings are cached per endpoint to keep your quota low.
  • Accuracy you can cite. Calculations are verified against the NASA JPL Horizons ephemeris.

Add a reading

Two ways, same result.

Gutenberg block: open the inserter, pick a block from the RoxyAPI category, and fill in the attributes in the sidebar.

Shortcode: paste one into any post or page. Pass attributes for a fixed reading you control:

[roxy_horoscope sign="leo"]
[roxy_natal_chart birth_date="1990-05-15" birth_time="14:30" lat="40.7128" lon="-74.0060" tz="America/New_York"]
[roxy_kundli birth_date="1990-05-15" birth_time="14:30" lat="51.5074" lon="-0.1278" tz="Europe/London"]
[roxy_tarot_card spread="three" question="What should I focus on this week"]
[roxy_numerology name="Ada Lovelace" birth_date="1815-12-10"]
[roxy_biorhythm birth_date="1990-05-15"]
[roxy_angel_number number="1111"]

Or leave the attributes off to render a visitor form instead. [roxy_natal_chart] shows a birth date, time, and city picker; [roxy_horoscope] shows a zodiac picker. The plugin validates the input, calls the service server side, and renders the result above the form.

Add a lang attribute to translate any reading, for example [roxy_horoscope sign="leo" lang="es"]. Two-person readings like synastry, Guna Milan, and compatibility always render a form for both people, so they take no attributes.

Every endpoint in the catalog has a matching shortcode, including newer Western readings like astrocartography, relocation and local-space charts, fixed stars, asteroids, progressions, solar arc, and annual profections. Browse the full, copy-pasteable list inside WordPress under RoxyAPI, Shortcodes once the plugin is active.

Sell readings and charts

You do not need a custom integration to charge for readings. Put any RoxyAPI shortcode or block on a page, then gate that page with a membership or paywall plugin such as Paid Memberships Pro, Restrict Content, or WP-Members, or sell access as a WooCommerce product through a memberships add-on. Members and buyers who reach the page see the reading; everyone else sees your paywall.

Because the chart renders exactly where you place the shortcode, you decide what stays free, like a teaser daily horoscope, and what is paid, like a full natal chart, a compatibility report, or a Vedic kundli. RoxyAPI keeps no birth data, so your client list and their details stay entirely yours.

Advanced: call the API directly

Building your own theme or plugin and prefer code over the official plugin? Store your key as a constant in wp-config.php (define( 'ROXY_API_KEY', '...' );), call any endpoint with wp_remote_post, and cache the response with a WordPress transient. The API reference has the live request and response for every endpoint, and the SDK guide and Next.js integration cover typed calls when you outgrow WordPress.

Frequently asked questions

Is the RoxyAPI WordPress plugin free?

The plugin is free and the source is GPL licensed. It renders readings on a free daily allowance with no account, so you can try it immediately. For production traffic, add an API key from a RoxyAPI plan, which removes the daily limit and covers every domain with one key.

Do I need an API key to start?

No. Install the plugin, drop a shortcode, and it works on the free daily allowance. Add a key when you are ready for production volume.

Can I sell astrology readings with WooCommerce?

Yes. Place a shortcode on a page and gate that page behind a WooCommerce product or a membership plugin. Only paying customers see the reading. You choose which readings are free and which are paid.

What can I add to my site?

Daily, weekly, and monthly horoscopes, Western natal charts, synastry and compatibility, astrocartography and relocation charts, Vedic kundli, panchang, dasha, doshas, KP charts, numerology, tarot, human design, forecasts, biorhythm, I Ching, crystals, dream symbols, and angel numbers. One plugin, 12+ domains.

Does it work with Elementor, Divi, or my page builder?

Yes. RoxyAPI shortcodes work in any page builder that supports WordPress shortcodes, including Elementor, Divi, Beaver Builder, and WPBakery. The Gutenberg blocks work in the default block editor.

Can my visitors enter their own birth details?

Yes. Drop a shortcode with no attributes and the plugin renders a form with a city search. The visitor fills in their birth date, time, and place, and the reading renders on the same page.

What languages does it support?

English, German, Hindi, Spanish, Turkish, Portuguese, French, and Russian. Set the language once and every reading follows it.

Is my API key safe?

Yes. The plugin calls the service server side in PHP, so the key never reaches the browser, and it is encrypted at rest. You can also store it as a constant in wp-config.php.

How accurate are the calculations?

Every astronomical calculation is verified against the NASA JPL Horizons ephemeris. See the methodology page for the testing approach.

Where to go next