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

Plans

Request an API Key →