# AstrologyAPI

> AstrologyAPI is a developer-first astrology platform providing 300+ REST API endpoints for birth charts, Kundli, horoscopes, transits, AI readings, PDF reports, and more. Trusted by 3,000+ products across 50+ countries, including Snap, Bumble, Shaadi.com, AstroTalk, and MSN. Handles 100M+ daily API calls with 99.99% uptime SLA.

AstrologyAPI gives developers production-grade astrology engines under a single API key — covering both Vedic (Jyotish) and Western traditions. It supports AI-powered chat grounded in real birth chart data, MCP server integration for LLMs, on-demand PDF report generation, and multi-language horoscope content feeds. The platform is built for entrepreneurs, developers, and businesses who want to integrate astrological features into their apps and websites — faster, more accurately, and at scale.

Authentication uses HTTP Basic Auth with a single API key across all 300+ endpoints: `Authorization: Basic base64(userId:apiKey)`. Pricing is pay-as-you-go (wallet top-up, no monthly commitments). New accounts get 50 free credits with no credit card required.

## Getting Started

- [AstrologyAPI Home](https://astrologyapi.com/): Main platform overview — birth charts, horoscopes, tarot, PDF reports, and AI readings.
- [Sign Up](https://astrologyapi.com/signup): Create a free account and get API keys in under 2 minutes. No credit card required.
- [Log In](https://astrologyapi.com/login): Access your API keys, usage dashboard, and developer tools.
- [Quick Start Guide](https://astrologyapi.com/developers/v1/quick-start): Step-by-step guide to make your first API call using User ID and API Key.
- [Access Token Usage Guide](https://www.astrologyapi.com/developers/v1/access-token-usage-guide): Authenticate API calls using the Access Token method.
- [Book a Demo](https://astrologyapi.com/demo-schedule): 30-minute live demo with the solutions team — real API calls, your use case, sandbox access.
- [API Status](https://www.astrologyapi.com/api-status): Check operational status of all AstrologyAPI services.
- [FAQ](https://www.astrologyapi.com/faq): Common questions about AstrologyAPI services and integration.

## Core Products

- [Astrology JSON API](https://astrologyapi.com/products/astrology-json-api): 300+ structured JSON endpoints covering Vedic, Western, KP, Human Design, numerology, and AI readings — one key, production-ready.
- [Astrology PDF API](https://astrologyapi.com/products/astrology-pdf-api): On-demand white-labeled PDF report generation (Kundli, matchmaking, Varshaphal, natal, synastry). Delivered via download link or webhook.
- [Horoscope API](https://astrologyapi.com/horoscope-api): Daily, weekly, and monthly horoscope feeds for all 12 zodiac signs in 22+ languages. Schedule-ready JSON for apps, CRM, chat, and memberships.
- [Geo Location API](https://astrologyapi.com/products/geo-location-api): Fast, accurate timezone and coordinate resolution for birth location inputs across 4.5 million cities worldwide.
- [AstroPages Website Builder](https://www.astrologyapi.com/products/astro-pages): Build and customize astrology websites without writing code.
- [Astrology WordPress Theme](https://www.astrologyapi.com/products/astrology-wordpress-theme): Comprehensive WordPress theme tailored for astrology websites.

## Vedic Astrology APIs

Covers Indian/Jyotish tradition. Includes birth chart (Kundli), all divisional charts, Vimshottari Dasha, Shadbala, Ashtakvarga, Bhavbala, Gochara, KP (Krishnamurti Paddhati) sub-lords, Lalkitab annual charts and planetary debts, Nadi charts, Panchang, muhurta, dosha analysis, and Kundli matchmaking (Ashtakoot and Dashkoot Guna Milan).

- [Vedic Astrology Overview](https://astrologyapi.com/vedic-astrology): Kundli generators, Panchang tools, muhurta pickers, matchmaking — full feature overview.
- [Vedic API Docs](https://astrologyapi.com/developers/v1/vedic): Complete Vedic astrology API documentation.
- [Vedic Match Making APIs](https://www.astrologyapi.com/vedic-astrology/match-making-api): Ashtakoot and Dashkoot Guna Milan compatibility APIs.
- [Planets API](https://astrologyapi.com/developers/v1/vedic/planets): Detailed astrological data for planetary positions at birth.
- [Current Vimshottari Dasha](https://astrologyapi.com/developers/v1/vedic/current_vdasha_date): Get the current Vimshottari Dasha period for a given date.
- [Kal Sarpa Dosha](https://astrologyapi.com/developers/v1/vedic/kalsarpa_details): Details on Kal Sarpa Dosha effects in a horoscope.
- [Rudraksha Suggestions](https://astrologyapi.com/developers/v1/vedic/rudraksha_suggestion): Personalized rudraksha bead recommendations based on horoscope.
- [Lal Kitab Planets](https://astrologyapi.com/developers/v1/vedic/lalkitab_planets): Vedic astrology planetary positions per Lal Kitab system.
- [Birth Details API](https://astrologyapi.com/docs/api-ref/3/birth_details): Retrieve detailed astrological data using birth information.
- [Astro Details API](https://astrologyapi.com/docs/api-ref/4/astro_details): Birth-based astrological insights via API.
- [Planetary Positions API](https://astrologyapi.com/docs/api-ref/5/planets): Astrological details of planetary positions at birth time.
- [Basic Panchang API](https://astrologyapi.com/docs/api-ref/15/basic_panchang): Detailed Hindu calendar data for specific dates.
- [Planet Panchang API](https://astrologyapi.com/docs/api-ref/16/planet_panchang): Celestial body positions and their attributes.
- [Current Vdasha API](https://astrologyapi.com/docs/api-ref/23/current_vdasha): Current Vimshottari Dasha periods in Vedic astrology.
- [Lalkitab Horoscope API](https://astrologyapi.com/docs/api-ref/26/lalkitab_horoscope): Detailed horoscope reports using Lal Kitab astrology.
- [Sarvashtak API](https://astrologyapi.com/docs/api-ref/31/sarvashtak): Sarvashtak data and Ashtak Varga information.
- [General Nakshatra Report](https://astrologyapi.com/docs/api-ref/37/general_nakshatra_report): Detailed Nakshatra analysis for personalized astrology insights.
- [General Ascendant Report](https://astrologyapi.com/docs/api-ref/38/general_ascendant_report): Ascendant traits and spiritual lessons.
- [Daily Nakshatra Prediction](https://astrologyapi.com/docs/api-ref/39/daily_nakshatra_prediction): Daily predictions based on nakshatra and moon sign.
- [Kal Sarpa Dosha (Docs)](https://astrologyapi.com/docs/api-ref/43/kalsarpa_details): Kal Sarpa Dosha effects in astrology.
- [Sub-Sub Chardasha API](https://astrologyapi.com/docs/api-ref/64/sub_sub_chardasha): Vedic astrology sub-sub period details.
- [Manglik Dosha API](https://astrologyapi.com/docs/api-ref/65/manglik): Check Manglik Dosha in horoscopes.
- [KP House Cusps API](https://astrologyapi.com/docs/api-ref/77/kp_house_cusps): KP house cusps calculation in astrology.
- [KP Birth Chart API](https://astrologyapi.com/docs/api-ref/78/kp_birth_chart): KP birth chart generation using astrology data.
- [Varshaphal Details API](https://astrologyapi.com/docs/api-ref/82/varshaphal_details): Annual horoscope details via the Varshaphal system.
- [Varshaphal Planet Information](https://astrologyapi.com/docs/api-ref/83/varshaphal_planets): Celestial positions and attributes for annual chart analysis.
- [Daily Nakshatra Consolidated](https://astrologyapi.com/docs/api-ref/108/daily_nakshatra_consolidated): Consolidated daily nakshatra predictions for personalized insights.
- [Tamil Panchang API](https://astrologyapi.com/docs/api-ref/114/tamil_panchang): Tamil calendar details and auspicious timings.
- [Matchmaking Detailed Report](https://astrologyapi.com/docs/api-ref/118/match_making_detailed_report): Detailed matchmaking analysis report.
- [Dashakoot Points API](https://astrologyapi.com/docs/api-ref/119/match_dashakoot_points): Calculate Dashakoot points for horoscope compatibility.
- [Lal Kitab Planets (Docs)](https://astrologyapi.com/docs/api-ref/150/lalkitab_planets): Lal Kitab planetary positions and details.
- [Monthly Panchang API](https://astrologyapi.com/docs/api-ref/172/monthly_panchang): Detailed Hindu calendar data for a full month.
- [Ghat Chakra API](https://astrologyapi.com/docs/api-ref/198/ghat_chakra): Identify astrologically unfavorable periods.
- [Astro Match Details API](https://astrologyapi.com/docs/api-ref/8/match_astro_details): Detailed astrological matchmaking data for couples.
- [Match Manglik Report](https://astrologyapi.com/docs/api-ref/12/match_manglik_report): Detailed Manglik dosha analysis for compatibility reports.
- [Timezone with DST](https://astrologyapi.com/docs/api-ref/92/timezone_with_dst): Timezone offsets including daylight saving time.

## Western Astrology APIs

Natal charts, synastry overlays, composite charts, transit reports, secondary progressions, solar arc directions, and AstroCartoGraphy (planetary lines, AC/DC/IC/MC, parans, city scoring).

- [Western Astrology Overview](https://astrologyapi.com/western-astrology): Natal charts, transit reports, and synastry — full feature overview.
- [Western API Docs](https://www.astrologyapi.com/western-api-docs): Complete Western astrology API documentation.
- [Western Chart Data API](https://astrologyapi.com/western-api-docs/api-ref/163/western_chart_data): Detailed Western astrology chart data for individuals.
- [Western Horoscope API](https://astrologyapi.com/western-api-docs/api-ref/164/western_horoscope): Celestial positions and properties for astrological insights.
- [Solar Return House Cusps](https://astrologyapi.com/developers/v1/western/solar_return_house_cusps): Solar return house cusps and related information.
- [Solar Return Planet Aspects](https://astrologyapi.com/developers/v1/western/solar_return_planet_aspects): Solar return planet aspect details and data.
- [Challenge Numbers API](https://astrologyapi.com/developers/v1/western/challenge_numbers): Challenge numbers and personal growth insights.
- [Solar Return PDF Docs](https://astrologyapi.com/docs/solar-return-pdf-docs): Generate customizable Solar Return PDF horoscopes.

## Horoscope Content APIs

Schedule-ready JSON feeds for daily, monthly, and yearly horoscopes. Covers love, career, health, luck, and lunar calendar content. Sun sign and ascendant-based, available in 22+ languages.

- [Horoscope API Product Page](https://astrologyapi.com/horoscope-api): Daily horoscope feeds for apps, CRM, chat, and memberships.
- [Horoscope API Docs](https://www.astrologyapi.com/horoscope-api-docs): Daily and monthly horoscopes for all zodiac signs.
- [AstrologyAPI Horoscope Reference](https://astrologyapi.com/developers/v1/horoscope): Full horoscope API endpoint reference.

## PDF Reports API

Automated generation of Kundli, matchmaking, Varshaphal, natal, synastry, and life forecast reports. White-labeled, multi-language, delivered via download link or webhook.

- [PDF API Product Page](https://astrologyapi.com/products/astrology-pdf-api): On-demand white-labeled PDF report generation.
- [PDF API Docs](https://astrologyapi.com/developers/v1/pdf): Full PDF report API documentation.
- [PDF Reports Overview](https://astrologyapi.com/docs/pdf-docs): Comprehensive PDF reporting options for astrology APIs.
- [PDF Reports API Reference](https://astrologyapi.com/docs/pdf-docs-api): PDF report API endpoint reference.
- [Professional Horoscope PDF](https://astrologyapi.com/developers/v1/pdf/pro-horoscope): Generate customized professional PDF horoscopes using birth details.
- [Pro PDF Docs](https://www.astrologyapi.com/docs/pro-pdf-docs): Generate customized PDF horoscopes with full birth details.

## Tarot API

Full 78-card engine (Major and Minor Arcana) with upright and reversed logic. Supports 3-card, 9-card, Celtic Cross, and Yes/No spreads. Card of the Day endpoint included.

- [Tarot Card API](https://astrologyapi.com/tarot-card-api): Tarot reading API with love, career, and finance insights.
- [Tarot API Docs](https://astrologyapi.com/tarot-api-docs): Full Tarot prediction API documentation and endpoint reference.

## AI Features

- [Astro Chat API](https://astrologyapi.com/astro-ai/chat-api): AI-powered personal astrologer grounded in the user's actual birth chart — not generic LLM responses. Available 24/7 for transit readings, love compatibility, and career guidance.
- [Chat API Docs](https://astrologyapi.com/developers/v1/chat-api): Full documentation for the conversational AI Chat API.
- [Palmistry API](https://astrologyapi.com/palm-reading-api): Upload a palm image and receive structured hand features, line analysis, life-aspect readings, and optional processed palm overlays.
- [Palmistry API Docs](https://astrologyapi.com/developers/v1/palm-reading-api): Integration flow and endpoint reference for palm scanning, feature extraction, focused readings, and processed images.
- [MCP Server Product Page](https://www.astrologyapi.com/astro-ai/mcp-server): Connect ChatGPT, Claude, or any LLM directly to real ephemeris data via the Model Context Protocol. Eliminates hallucinated chart data. 109 specialized tools, no code required.
- [MCP Server Docs](https://astrologyapi.com/developers/v1/mcp-server): Technical documentation for AstrologyAPI's MCP Server integration.

## Additional API Categories

- [Numerology API](https://astrologyapi.com/numerology-api): Pythagorean, Chaldean, Vedic, and Kabbalah systems. Life path, soul urge, Lo Shu grid, name correction, and compatibility numbers.
- [Numerology Table API](https://astrologyapi.com/docs/api-ref/45/numero_table): Numerology insights including destiny number, expression number, and favorite elements.
- [Chinese Astrology API](https://www.astrologyapi.com/chinese-astrology-api): Chinese astrology features, forecasts, and engagement tools.
- [Human Design API](https://astrologyapi.com/products/astrology-json-api): BodyGraph for individuals and couples, HD compatibility, transit gate API, and full Human Design dataset.
- [Compatibility API](https://www.astrologyapi.com/vedic-astrology/match-making-api): Ashtakoot Guna Milan and Dashkoot for Vedic; full synastry and composite charts for Western.

## Developer Resources

- [Developer Hub](https://astrologyapi.com/developers/v1): Full documentation hub — guides, API reference, Postman collections, SDKs, and change log.
- [API Reference](https://astrologyapi.com/developers/v1/api-reference): Complete reference for all 300+ endpoints.
- [SDK Reference](https://astrologyapi.com/developers/v1/sdk-reference): Official SDKs for multiple languages with authentication, retries, and error handling built in.
- [Postman Collection](https://astrologyapi.com/developers/v1/postman-collection): Pre-built Postman collection covering Vedic and Western endpoints for quick testing.
- [Change Log](https://astrologyapi.com/developers/v1/change-log): Release history and API updates.
- [Indian Astrology Docs](https://astrologyapi.com/docs/indian-astrology): Comprehensive Indian astrology API documentation.

## Pricing

- [Pricing Overview](https://astrologyapi.com/pricing): Pay-as-you-go wallet model. No monthly commitments. Top up and pay per API call. 50 free credits on signup, no credit card required.
- [Indian Astrology Pricing](https://astrologyapi.com/pricing/indian-astrology-pricing): Pricing plans for Indian/Vedic astrology APIs.
- [Western Astrology Pricing](https://astrologyapi.com/pricing/western-astrology-pricing): Pricing plans for Western astrology APIs.
- [Horoscope API Pricing](https://astrologyapi.com/pricing/horoscopes-pricing): Pricing for daily horoscope API services.

## Solutions by Use Case

- [Astrology Apps](https://astrologyapi.com/use-case/astrology-apps): Build engaging astrology apps with comprehensive APIs and content features.
- [Dating & Matrimonial](https://astrologyapi.com/use-case/dating-matrimonial): Enhance dating and matchmaking platforms with astrology-based compatibility.
- [Jewellery & Gemstones](https://astrologyapi.com/use-case/jewellery-gemstones): APIs for gemstone recommendations and astrological product pairing.
- [Utility & Lifestyle](https://astrologyapi.com/use-case/utility-lifestyle): Integrate astrology APIs for lifestyle apps and personalized predictions.

## Company

- [About Us](https://astrologyapi.com/about-us): AstrologyAPI is the calculation and content layer behind thousands of astrology products worldwide. In production since 2013.
- [Contact](https://astrologyapi.com/contact): Contact the solutions team for API questions, integration support, or migration help.
- [Contact Sales](https://astrologyapi.com/contact-sales): Enterprise onboarding, custom endpoints, volume pricing. Response within one business day.

## Legal

- [Privacy Policy](https://astrologyapi.com/legal/privacy-policy): Data collection and usage practices.
- [Terms of Service](https://astrologyapi.com/legal/terms-service): Terms and conditions for using AstrologyAPI services.
- [Refund and Cancellation Policy](https://astrologyapi.com/legal/refund-and-cancellation): All purchases are final and non-refundable.