Kua Number API

Quick Start

Make a GET request with your API key and the person's birth year and gender:

GET https://www.searchyourastrologer.com/api/v1/kua-number.php
    ?key=YOUR_API_KEY
    &year=1990
    &gender=male
    &month=6
    &day=15

Example (cURL)

curl "https://www.searchyourastrologer.com/api/v1/kua-number.php?key=YOUR_API_KEY&year=1990&gender=male"

Example (JavaScript fetch)

fetch("https://www.searchyourastrologer.com/api/v1/kua-number.php?key=YOUR_API_KEY&year=1990&gender=male")
  .then(res => res.json())
  .then(data => console.log(data));

Request Parameters

Param	Required	Description
key	Yes	Your API key
year	Yes	Birth year, e.g. 1990
gender	Yes	male or female
month	No	Birth month (1-12) — improves accuracy for Jan/early-Feb births
day	No	Birth date (1-31)

Example Response

{
  "success": true,
  "input": { "year": 1990, "gender": "male" },
  "result": {
    "kua_number": 1,
    "group": "East",
    "lucky_directions": {
      "sheng_chi": { "direction": "Southeast", "meaning": "Success & Wealth" },
      "tien_yi":   { "direction": "East", "meaning": "Health" },
      "nien_yen":  { "direction": "South", "meaning": "Love & Relationships" },
      "fu_wei":    { "direction": "North", "meaning": "Personal Growth" }
    },
    "unlucky_directions": {
      "ho_hai":     { "direction": "West", "meaning": "Obstacles" },
      "wu_kwei":    { "direction": "Northeast", "meaning": "Problems" },
      "lui_sha":    { "direction": "Northwest", "meaning": "Conflict" },
      "chueh_ming": { "direction": "Southwest", "meaning": "Total Loss" }
    }
  },
  "usage": { "calls_today": 3, "daily_limit": 500, "plan": "basic" }
}

Error Responses

HTTP Status	Meaning
401	Missing or invalid API key
403	Key deactivated or expired
429	Daily rate limit reached — upgrade your plan
400	Invalid year/gender parameter

Pitridosh Report API

A separate subscription — its own dedicated API key. Detects 8 classical Pitru Dosha indicators from a full birth chart using real planetary positions.

GET https://www.searchyourastrologer.com/api/v1/pitridosh.php
    ?key=YOUR_API_KEY
    &year=1990&month=6&day=15&hour=14&minute=30
    &tz=5.5&lat=28.6139&lon=77.2090

Param	Required	Description
key	Yes	Your Pitridosh Report API key
year, month, day	Yes	Birth date
hour, minute	Yes / No	Birth time, 24-hour format (minute defaults to 0)
tz	Yes	Timezone offset from UTC, e.g. 5.5 for IST
lat, lon	Yes	Birth location coordinates

{
  "success": true,
  "result": {
    "pitru_dosha_present": true,
    "severity": "Halka (Mild)",
    "indicators_matched": 1,
    "indicators_checked": 8,
    "indicators": [
      { "name": "Surya-Rahu Yuti (Sun-Rahu conjunction)", "present": false, "note": "..." },
      { "name": "9th Lord in Dusthana (6th/8th/12th house)", "present": true, "note": "..." }
    ]
  }
}

Kua Number API — Plans

Pitridosh Report API — Plans

Subscribe & Get API Key →