Sitelet https://roxyapi.com/widgets#reference-card
Skip to content
Copy and pasteNo codeAny websiteBrowser-safe key

Add astrology to your site. One snippet, no backend.

Drop-in widgets for horoscopes, natal charts, Vedic kundli, forecast, human design, numerology, tarot, and every other RoxyAPI domain. Paste one snippet or one hosted URL, add your publishable key, and the widget renders its own inputs and fetches live readings on Squarespace, WordPress, Wix, or plain HTML.

Every widget, ready to paste.

72 widgets across 20 categories, each rendering live data from one endpoint. Pick a category to jump straight to it.

Set it up once

Every snippet below updates instantly. Your key stays in your browser, this page sends nothing to RoxyAPI.

No key yet? Create a publishable key in your account dashboard and list your site origin.

Match the page follows your site language. Pick one to fix it.

Off by default. Tick to add a small link back to RoxyAPI under every reading.

Live in three steps.

No servers, no build tools, no framework. Get a key, copy a snippet, paste it where the reading should appear.

Step 1

Get a publishable key

Create a publishable key in your account dashboard and add your site domain to its origin allowlist. It starts with pk_ and is safe to put in public page source.

Step 2

Copy a snippet

Drop your key in the box above the widgets, pick a language if you want one fixed, and every snippet on this page updates. Copy the ready-to-paste snippet or hosted URL for the widget you want.

Step 3

Paste it in

Drop the snippet into a code block, or paste the embed URL into any block that accepts a link. The widget renders its own form, fetches on submit, and shows the result.

Platform walkthroughs: Squarespace, Wix, Shopify, and WordPress.

One platform behind the widgets

Widgets are the no-code mode of the platform. One publishable key on your site, one flat subscription behind it, and the typed API, Remote MCP servers, SDKs, and UI components included when you are ready for code.

One API keyOne flat plan, all inclusive
  • Typed API: a complete result in one call, from a live typed OpenAPI spec
  • Remote MCP: hosted agent tools over Streamable HTTP, no local setup
  • Typed SDKs: TypeScript, Python, PHP, C#, and Go, generated from the spec
  • UI components: natal wheels, kundli, bodygraphs, and spreads rendered from the response
  • Embed widgets: paste one snippet on any site with a browser safe publishable key
  • Templates: MIT licensed apps to clone, white label, and ship as your own
  • Multilingual i18n: full interpretation text in 10+ languages, included in every plan

Every surface, across all 18 domains, under one flat subscription. No per-product fees, no per-request or token costs.

Common questions

Copy-paste widgets render live readings from the RoxyAPI catalog with a browser-safe publishable key. No backend, no build step.

How do I add an astrology widget to my website?

Choose an available widget at /widgets, such as a natal chart, horoscope or tarot reading. The gallery supplies a snippet or hosted embed link that you configure with your publishable key. Widgets fetch and display live readings without a backend of your own.

Do I need to know how to code to use RoxyAPI widgets?

The gallery provides copy-and-paste snippets and hosted embed links. Choose a widget, replace the sample key with your publishable key and paste the result into a supported block on your site. Interactive widgets supply the inputs relevant to their reading, such as birth details or a zodiac selection.

Which websites can use the widgets?

Use a script snippet on a site that permits custom scripts, or an iframe or hosted embed link where those are supported. Site permissions and content restrictions determine which option works. The official WordPress plugin provides another path for WordPress sites.

How do I get a publishable key for my widgets?

Create a publishable key in the account dashboard and allow the site origins that will host your widgets. Widget calls count against the subscription allowance, so review usage and revoke a key you no longer need. Keep secret keys on your server and follow the key guidance at /docs/authentication.

Do widgets need a backend on my website?

Widgets can fetch readings without a backend of your own. Configure the publishable key for your site origins and use an embed format your host permits. The setup guide at /docs/widgets covers script snippets, iframes and hosted links.

Can I match the widgets to my brand?

Widgets support CSS custom properties for colors, fonts, spacing and other theme choices. The gallery includes a practitioner theme and light or dark appearance options. Choose your theme before copying a snippet or embed link.

Is there a RoxyAPI credit line on the widgets?

Attribution is optional on every plan. Enable Credit RoxyAPI in the widgets gallery if you want a source link under the reading. Leave that option disabled to display the widget without a credit line.

Can I show a widget in another language?

Choose a language in the gallery to configure the reading and supported interface labels. API localization spans 10+ languages: English, Turkish, German, Spanish, Hindi, Portuguese, French, Russian, Chinese (Simplified), Chinese (Traditional), with coverage varying by domain and field. Some form headings and untranslated component labels remain in English; see /docs/ui for current coverage.

Are the widgets free?

The widget components are MIT licensed and free to use and modify under that license. Live readings require a RoxyAPI subscription and consume its request allowance. The same subscription covers the domains used by your supported widgets.

Get a publishable key. Ship your first widget today.

One key powers every widget on your site. All domains, one flat plan.

Component preview

The real component, running on sample data.

Loading the component...