KundaliCheck API & Embed Documentation

Add free Vedic Astrology features to your own website in 2 lines of code 100% FREE

1. Getting Started
2. Basic Embed
3. Page Selection — embed any feature
4. Embed a specific generated Kundali
5. Theming & Customization
6. All URL Parameters
7. Snippet Generator
8. FAQ & Terms

1. Getting Started

The KundaliCheck embed widget lets you add a Vedic Astrology calculator (or any individual feature — daily forecast, matchmaking, dasha, etc.) to your website with just two lines of code. It's completely free.

Create a free account at kundalicheck.com — click the Login button at the top, then Register Free.

Generate an API key from the Login menu → API Keys section. You can generate as many keys as you want.

Paste the embed snippet on your website (see examples below).

2. Basic Embed — Birth Chart Generator

This shows the full birth chart generator. Visitors can enter their birth details and get a complete Kundali on your site.

<div id="kundali-widget-myid"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=myid"></script>

Note: Replace YOUR_API_KEY with the key you generated. The id can be any short identifier (letters/numbers) — it just needs to match the div id.

3. Embed a Specific Page

Use the page parameter to embed only one feature instead of the full app:

Birth Chart (default)

<div id="kundali-widget-chart1"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=chart1&page=chart"></script>

Daily Forecast

<div id="kundali-widget-pred1"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=pred1&page=predictions"></script>

Kundali Matchmaking (Guna Milan)

<div id="kundali-widget-match1"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=match1&page=matchmaking"></script>

Vimshottari Dasha

<div id="kundali-widget-dasha1"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=dasha1&page=dasha"></script>

Period Analysis

<div id="kundali-widget-per1"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=per1&page=periods"></script>

Life Analysis

<div id="kundali-widget-anal1"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=anal1&page=analysis"></script>

Live Planet Positions

<div id="kundali-widget-pl1"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=pl1&page=planets"></script>

Tools (Muhurat, Baby Names, etc.)

<div id="kundali-widget-tools1"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=tools1&page=tools"></script>

If a visitor on KundaliCheck clicks the Share This Kundali button, they get a unique share_id like abc123xyz. You can embed that exact pre-loaded kundali on your site:

<div id="kundali-widget-shared1"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=shared1&share=SHARE_ID&page=chart"></script>

Use case: Astrologers can generate a kundali for a client, share the URL, and embed that exact reading on their own blog or client portal.

5. Theming & Customization

You can customize the colors of the embedded widget to match your site. Use these URL parameters:

Parameter	Description	Example
`bg`	Background color (hex without #)	`bg=0a0a1a`
`accent`	Accent / gold color	`accent=d4a843`
`text`	Primary text color	`text=e8e8f0`
`theme`	`dark` (default) or `light`	`theme=dark`
`lang`	Initial language: `en`, `np_dev`, `np_rom`	`lang=np_dev`
`height`	Iframe height in pixels (300–2000)	`height=900`

Themed example

<div id="kundali-widget-themed"></div>
<script src="https://kundalicheck.com/api/widget.js.php?key=YOUR_API_KEY&id=themed&page=chart&bg=1a0e2e&accent=ffb84d&text=ffffff&height=800"></script>

6. Complete URL Parameter Reference

Param	Required	Values	Description
`key`	✅ Yes	Your API key	Generated from your KundaliCheck account
`id`	✅ Yes	Alphanumeric	Must match the `<div id="kundali-widget-{id}">`
`page`	Optional	chart, analysis, predictions, periods, dasha, matchmaking, planets, tools	Which feature to show
`share`	Optional	Share ID	Load a specific pre-generated kundali
`lang`	Optional	en, np_dev, np_rom	Initial language
`theme`	Optional	dark, light	Base theme (default: dark)
`bg`	Optional	Hex (no #)	Background color
`accent`	Optional	Hex (no #)	Accent color
`text`	Optional	Hex (no #)	Text color
`height`	Optional	300–2000	Iframe height in pixels

7. Snippet Generator

Configure your widget below and copy the generated snippet:

Build Your Embed Snippet

API Key

Page

Language

Pre-loaded Share ID (optional)

Background

Accent

Text

Height (px)

Your Snippet

8. FAQ & Terms

Is this really free?

Yes — completely free. No usage limits, no payment required. We built KundaliCheck to make Vedic astrology accessible to everyone, especially Nepali users who can't afford paid services.

Can I remove the "Powered by KundaliCheck.com" attribution?

No. The attribution must remain visible. Our widget includes automatic tamper detection — if the attribution is hidden, removed, or covered, the widget will be disabled. This is the only thing we ask in exchange for free use.

Can I use this commercially?

Yes, on personal blogs, astrology business websites, news sites, etc. Just keep the attribution visible.

How accurate are the calculations?

All calculations use standard Vedic astronomy formulas with Lahiri Ayanamsa by default (Modern Indian Government standard). Other ayanamsa systems (Krishnamurti, Surya Siddhanta, Yukteshwar, Raman, Fagan-Bradley, J.N. Bhasin, True Chitra Paksha, Nepali Traditional) are also supported.

Will my visitors' birth data be stored?

No. By default, all calculations happen client-side in the browser. Only if a visitor explicitly clicks "Share This Kundali" is the data stored on our servers (and only the data they typed in).

How do I report a bug?

Email hello@kundalicheck.com or open an issue on our GitHub.

Ready to embed? ← Generate your free API key