ਜੋਤਿਸ਼ ਏਪੀਆਈ

ਸ਼ਾਸਤਰੀ ਪਰੰਪਰਾ ਵਿੱਚ ਜੜ੍ਹਾਂ ਵਾਲਾ

ਕੁੰਡਲੀਆਂ ਅਤੇ ਫਲਾਦੇਸ਼ ਪਾਰਾਸ਼ਰੀ ਪਰੰਪਰਾ ਦੀ ਪਾਲਣਾ ਕਰਦੇ ਹਨ, ਜਿਵੇਂ ਬ੍ਰਿਹਤ ਪਾਰਾਸ਼ਰ ਹੋਰਾ ਸ਼ਾਸਤਰ, ਫਲਦੀਪਿਕਾ, ਸਾਰਾਵਲੀ ਅਤੇ ਜਾਤਕ ਪਾਰਿਜਾਤ ਵਿੱਚ ਸਿਖਾਇਆ ਗਿਆ ਹੈ। ਵਿਆਹ ਮਿਲਾਨ ਵਿੱਚ ਉੱਤਰ ਭਾਰਤ ਦਾ ਅਸ਼ਟਕੂਟ ਗੁਣ ਮਿਲਾਨ ਅਤੇ ਦੱਖਣ ਭਾਰਤ ਦੀ ਦਸ ਪੋਰੁੱਤਮ ਵਿਧੀ ਦੋਵੇਂ ਹਨ, ਅਤੇ ਵਾਸਤੂ ਸੋਲ੍ਹਾਂ ਦਿਸ਼ਾ ਖੇਤਰਾਂ ਅਤੇ ਵਾਸਤੂ ਪੁਰਸ਼ ਮੰਡਲ ਦੇ ਪੰਤਾਲੀ ਦੇਵਤਿਆਂ ਉੱਤੇ ਚੱਲਦਾ ਹੈ।

ਤੁਹਾਡੀ ਕੁੰਜੀ

ਹਰ ਬੇਨਤੀ ਨਾਲ ਆਪਣੀ ਕੁੰਜੀ ਬੇਨਤੀ ਦੇ ਸਿਰਲੇਖ ਵਿੱਚ ਭੇਜੋ। ਅਸੀਂ ਕੁੰਜੀ ਦੀ ਸਿਰਫ਼ ਇੱਕਪਾਸੜ ਛਾਪ ਰੱਖਦੇ ਹਾਂ, ਇਸ ਲਈ ਤੁਹਾਨੂੰ ਦਿਖਾਈ ਗਈ ਗੁਪਤ ਕੁੰਜੀ ਸੁਰੱਖਿਅਤ ਰੱਖੋ; ਜੇ ਉਹ ਕਦੇ ਬਾਹਰ ਆ ਜਾਵੇ ਤਾਂ ਉਸਨੂੰ ਰੱਦ ਕਰਕੇ ਆਪਣੇ ਕੰਟਰੋਲ ਪੈਨਲ ਤੋਂ ਨਵੀਂ ਕੁੰਜੀ ਬਣਾਓ।

curl -H "X-API-Key: YOUR_KEY" \
  "https://YOUR_HOST/v1/astro/panchang/sunrise?date=20/10/2026&lat=13.0827&lon=80.2707&tz=5.5"

ਚੌਦਾਂ ਭਾਸ਼ਾਵਾਂ, ਹਰ ਇੱਕ ਆਪਣੀ ਲਿਪੀ ਵਿੱਚ

ਕਿਸੇ ਵੀ ਬੇਨਤੀ ਵਿੱਚ ਭਾਸ਼ਾ ਦਾ ਮਾਪਦੰਡ ਜੋੜੋ। ਗ੍ਰਹਿ, ਰਾਸ਼ੀਆਂ, ਨਕਸ਼ੱਤਰ ਅਤੇ ਹਰ ਫਲਾਦੇਸ਼ ਉਸ ਭਾਸ਼ਾ ਦੀ ਆਪਣੀ ਲਿਪੀ ਅਤੇ ਉਸਦੇ ਰਵਾਇਤੀ ਸ਼ਬਦਾਂ ਵਿੱਚ ਆਉਂਦੇ ਹਨ, ਕਿਸੇ ਹੋਰ ਲਿਪੀ ਦੀ ਮਿਲਾਵਟ ਤੋਂ ਬਿਨਾਂ।

lang = en | ta | te | kn | hi | ml | sa | bn | gu | es | mr | pa | or | ur

curl -H "X-API-Key: YOUR_KEY" \
  "https://YOUR_HOST/v1/astro/horoscope/planet-details?dob=11/03/1994&tob=11:40&lat=13.0827&lon=80.2707&tz=5.5&lang=ta"

ਤੁਸੀਂ ਕੀ ਮੰਗ ਸਕਦੇ ਹੋ

ਕਿਸੇ ਵੀ ਦਿਨ ਅਤੇ ਥਾਂ ਦਾ ਪੰਚਾਂਗ, ਵਰਗ ਚੱਕਰਾਂ ਸਮੇਤ ਜਨਮ ਕੁੰਡਲੀ, ਅਸ਼ਟਕੂਟ ਅਤੇ ਪੋਰੁੱਤਮ ਮਿਲਾਨ, ਵਿੰਸ਼ੋਤਰੀ ਸਮੇਤ ਹੋਰ ਦਸ਼ਾਵਾਂ, ਦੋਸ਼ ਜਾਂਚ, ਰੋਜ਼ਾਨਾ ਤੋਂ ਸਾਲਾਨਾ ਰਾਸ਼ੀਫਲ, ਅੰਕ ਵਿਗਿਆਨ ਅਤੇ ਵਾਸਤੂ ਦੀਆਂ ਮੂਲ ਗੱਲਾਂ। ਹਰ ਮਾਪਦੰਡ ਸਮੇਤ ਪੂਰੀ ਸੂਚੀ ਹੇਠਾਂ ਹਵਾਲੇ ਵਿੱਚ ਅਤੇ ਉਤਾਰੇ ਜਾ ਸਕਣ ਵਾਲੇ ਵੇਰਵੇ ਵਿੱਚ ਹੈ।

/v1/astro/panchang/...      panchang, sunrise, hora, choghadiya, festivals
/v1/astro/horoscope/...     planet-details, divisional-charts, ashtakvarga
/v1/astro/extended/...      extended-kundli-details, kp-planets, current-sade-sati
/v1/astro/matching/...      south-match (porutham), ashtakoot, dashakoot
/v1/astro/dashas/...        maha-dasha, antar-dasha, yogini-dasha-main, char-dasha-main
/v1/astro/dosha/...         mangal-dosh, kaalsarp-dosh, pitra-dosh
/v1/astro/prediction/...    daily-moon, weekly-moon, yearly, numerology
/v1/astro/utilities/...     radical-number-details, gem-details, geo-search
/v1/astro/vastu/zones       vastu basics
/v1/vastu/...               plot grid, entrance, score, ayadi

ਤਿੰਨ ਆਕਾਰਾਂ ਵਿੱਚ ਪੂਰੀਆਂ ਰਿਪੋਰਟਾਂ

ਸਾਡੇ ਜਾਂਚੇ ਹੋਏ ਨਿਯਮ ਅਧਾਰਤ ਫਲਾਦੇਸ਼ ਭੰਡਾਰ ਤੋਂ ਬਣੀ ਪੂਰੀ ਰਿਪੋਰਟ ਮੰਗੋ, ਜਾਂ ਉਨ੍ਹਾਂ ਹੀ ਕੁੰਡਲੀ ਤੱਥਾਂ ਉੱਤੇ ਬਣਾਉਟੀ ਬੁੱਧੀ ਦਾ ਲਿਖਿਆ ਵਰਣਨ। ਹਰ ਰਿਪੋਰਟ ਬਣਤਰ ਵਾਲੇ ਪਾਠ, ਸਜਾਏ ਦਸਤਾਵੇਜ਼, ਬੋਲ ਕੇ ਸੁਣਾਏ ਫਲਾਦੇਸ਼ ਜਾਂ ਕੁੰਡਲੀ ਫ਼ਿਲਮ ਵਜੋਂ ਮਿਲਦੀ ਹੈ, ਅਤੇ ਹਰ ਇੱਕ ਛੋਟੇ, ਦਰਮਿਆਨੇ ਜਾਂ ਵਿਸਤ੍ਰਿਤ ਆਕਾਰ ਵਿੱਚ।

curl -X POST "https://YOUR_HOST/v1/astro/report/natal" \
  -H "X-API-Key: YOUR_KEY" -H "content-type: application/json" \
  -d '{"dob":"11/03/1994","tob":"11:40","lat":13.0827,"lon":80.2707,"tz":5.5,
       "lang":"hi","format":"pdf","size":"detailed"}'

format = json | pdf | audio | film
size   = small | medium | detailed
/v1/astro/report/{family}     rule based
/v1/astro/ai_report/{family}  AI narrative

ਲੰਮਾ ਕੰਮ ਇੱਕ ਕਾਰਜ ਵਜੋਂ ਚੱਲਦਾ ਹੈ

ਅਸਮਕਾਲੀ ਵਿਕਲਪ ਜੋੜੋ ਅਤੇ ਬੇਨਤੀ ਤੁਰੰਤ ਇੱਕ ਕਾਰਜ ਨੰਬਰ ਨਾਲ ਜਵਾਬ ਦਿੰਦੀ ਹੈ। ਜਦੋਂ ਚਾਹੋ ਉਸਦੀ ਸਥਿਤੀ ਦੇਖੋ, ਜਾਂ ਸਾਨੂੰ ਇੱਕ ਪਤਾ ਦਿਓ, ਕੰਮ ਤਿਆਰ ਹੁੰਦੇ ਹੀ ਅਸੀਂ ਉੱਥੇ ਸੂਚਨਾ ਭੇਜਾਂਗੇ। ਬੋਲੀਆਂ ਰਿਪੋਰਟਾਂ ਅਤੇ ਫ਼ਿਲਮਾਂ ਹਮੇਸ਼ਾ ਇਸੇ ਤਰ੍ਹਾਂ ਚੱਲਦੀਆਂ ਹਨ।

POST /v1/astro/ai_report/natal
{ ..., "format": "audio", "size": "medium", "async": true,
  "webhook_url": "https://example.com/hooks/astro" }

202 { "status": "ok", "response": { "job": { "id": "...", "status": "queued",
      "poll_url": "/v1/astro/jobs/..." } } }

GET /v1/astro/jobs/{id}   queued | running | rendering | done | failed

ਦਸਤਖ਼ਤ ਕੀਤੀਆਂ ਸੂਚਨਾਵਾਂ

ਹਰ ਸੂਚਨਾ ਨਾਲ ਇੱਕ ਸਮਾਂ ਮੋਹਰ ਅਤੇ ਤੁਹਾਡੀ ਕੁੰਜੀ ਦੇ ਆਪਣੇ ਭੇਤ ਨਾਲ ਬਣੇ ਦਸਤਖ਼ਤ ਹੁੰਦੇ ਹਨ। ਸੁਨੇਹੇ ਉੱਤੇ ਭਰੋਸਾ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਦਸਤਖ਼ਤ ਜਾਂਚੋ ਅਤੇ ਛੇਤੀ ਸਫਲਤਾ ਦੇ ਸੰਕੇਤ ਨਾਲ ਜਵਾਬ ਦਿਓ; ਜਵਾਬ ਨਾ ਮਿਲੇ ਤਾਂ ਅਸੀਂ ਵਧਦੇ ਵਕਫ਼ਿਆਂ ਨਾਲ ਕੁਝ ਵਾਰ ਹੋਰ ਕੋਸ਼ਿਸ਼ ਕਰਦੇ ਹਾਂ।

// Node.js
const crypto = require('crypto');
function verify(rawBody, headers, secret) {
  const ts = headers['x-webhook-timestamp'];
  const expected = 'v1=' + crypto.createHmac('sha256', secret)
    .update(ts + '.' + rawBody).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(headers['x-webhook-signature']));
}

ਕ੍ਰੈਡਿਟ ਅਤੇ ਕ੍ਰੈਡਿਟ ਪੈਕ

ਹਰ ਬੇਨਤੀ ਪਹਿਲਾਂ ਤੁਹਾਡੀ ਯੋਜਨਾ ਦੇ ਮਹੀਨਾਵਾਰ ਹਿੱਸੇ ਵਿੱਚੋਂ, ਫਿਰ ਤੁਹਾਡੇ ਕੋਲ ਮੌਜੂਦ ਕ੍ਰੈਡਿਟ ਪੈਕਾਂ ਵਿੱਚੋਂ ਕ੍ਰੈਡਿਟ ਵਰਤਦੀ ਹੈ। ਹਰ ਜਵਾਬ ਦੱਸਦਾ ਹੈ ਕਿ ਕਿੰਨੇ ਕ੍ਰੈਡਿਟ ਲੱਗੇ ਅਤੇ ਕਿੰਨੇ ਬਾਕੀ ਹਨ, ਇਸ ਲਈ ਕੋਈ ਹੈਰਾਨੀ ਨਹੀਂ ਹੁੰਦੀ।

X-Credits-Used: 8
X-Credits-Remaining: 9992

"meta": { "credits": 8, "remaining": 9992, "request_id": "..." }

ਵਾਜਬ ਵਰਤੋਂ ਦੀਆਂ ਹੱਦਾਂ

ਹਰ ਕੁੰਜੀ ਦੀ ਉਸਦੀ ਯੋਜਨਾ ਅਨੁਸਾਰ ਪ੍ਰਤੀ ਮਿੰਟ ਇੱਕ ਹੱਦ ਹੁੰਦੀ ਹੈ। ਹੱਦ ਲੰਘਣ ਉੱਤੇ ਬੇਨਤੀ ਸਪਸ਼ਟ ਸੰਕੇਤ ਅਤੇ ਦੁਬਾਰਾ ਕਦੋਂ ਕੋਸ਼ਿਸ਼ ਕਰਨੀ ਹੈ ਦੇ ਇਸ਼ਾਰੇ ਨਾਲ ਨਿਮਰਤਾ ਨਾਲ ਮੋੜ ਦਿੱਤੀ ਜਾਂਦੀ ਹੈ।

HTTP/1.1 429
Retry-After: 60
X-RateLimit-Limit: 60

{ "status": "error", "error": { "code": "rate_limited", "message": "..." } }

ਸੁਰੱਖਿਅਤ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼

ਕੁਝ ਨਵਾਂ ਬਣਾਉਣ ਵਾਲੀ ਬੇਨਤੀ ਭੇਜਦੇ ਸਮੇਂ ਆਪਣੀ ਇੱਕ ਵਿਲੱਖਣ ਬੇਨਤੀ ਕੁੰਜੀ ਜੋੜੋ। ਜੁੜਤ ਟੁੱਟਣ ਉੱਤੇ ਦੁਬਾਰਾ ਭੇਜੋ ਤਾਂ ਵੀ ਤੁਹਾਨੂੰ ਪਹਿਲਾ ਜਵਾਬ ਹੀ ਮਿਲਦਾ ਹੈ, ਅਤੇ ਕਦੇ ਦੋ ਵਾਰ ਖ਼ਰਚਾ ਨਹੀਂ ਕੱਟਦਾ।

curl -X POST "https://YOUR_HOST/v1/astro/report/match" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Idempotency-Key: order-2026-10-20-0001" \
  -d '{ ... }'

Idempotent-Replayed: true   (on a repeated request)

ਹਰ ਗਲਤੀ ਦਾ ਇੱਕੋ ਰੂਪ

ਹਰ ਇਨਕਾਰ ਦਾ ਰੂਪ ਇੱਕੋ ਜਿਹਾ ਹੁੰਦਾ ਹੈ: ਇੱਕ ਛੋਟਾ ਸੰਕੇਤ ਜਿਸ ਉੱਤੇ ਤੁਸੀਂ ਕਾਰਵਾਈ ਕਰ ਸਕੋ, ਇੱਕ ਸਾਦਾ ਸੁਨੇਹਾ ਅਤੇ ਜਿੱਥੇ ਲਾਭਦਾਇਕ ਹੋਵੇ ਉੱਥੇ ਠੀਕ ਕਰਨ ਵਾਲੇ ਮਾਪਦੰਡ ਦਾ ਨਾਮ।

{
  "status": "error",
  "error": { "code": "param_missing", "message": "...", "param": "tob" },
  "meta": { "request_id": "..." }
}

ਸਥਿਰ ਸੰਸਕਰਣ

ਸੰਸਕਰਣ ਪਤੇ ਦਾ ਹੀ ਹਿੱਸਾ ਹੈ, ਇਸ ਲਈ ਸਾਡੇ ਵਧਣ ਨਾਲ ਵੀ ਤੁਹਾਡਾ ਜੋੜ ਚੱਲਦਾ ਰਹਿੰਦਾ ਹੈ। ਜਵਾਬਾਂ ਵਿੱਚ ਨਵੇਂ ਖੇਤਰ ਆ ਸਕਦੇ ਹਨ; ਜੋ ਕੁਝ ਤੁਹਾਡਾ ਪ੍ਰੋਗਰਾਮ ਤੋੜ ਸਕਦਾ ਹੈ ਉਹ ਸਿਰਫ਼ ਨਵੇਂ ਸੰਸਕਰਣ ਵਿੱਚ ਆਉਂਦਾ ਹੈ।

https://YOUR_HOST/v1/astro/...
Api-Version: 1          (optional request header)
X-Api-Version: 1.0.0    (every answer)

ਫਲਾਦੇਸ਼ ਭੰਡਾਰ

ਜਿਨ੍ਹਾਂ ਯੋਜਨਾਵਾਂ ਵਿੱਚ ਇਹ ਸ਼ਾਮਲ ਹੈ, ਉਨ੍ਹਾਂ ਵਿੱਚ ਤੁਸੀਂ ਸਾਡਾ ਪੂਰਾ ਜਾਂਚਿਆ ਫਲਾਦੇਸ਼ ਭੰਡਾਰ ਭਾਗ ਦਰ ਭਾਗ ਅਤੇ ਸਫ਼ਾ ਦਰ ਸਫ਼ਾ, ਹਰ ਭਾਸ਼ਾ ਵਿੱਚ ਅਤੇ ਬਿਨਾਂ ਕਿਸੇ ਕਟੌਤੀ ਦੇ ਪੜ੍ਹ ਕੇ ਆਪਣੇ ਅਨੁਭਵ ਬਣਾ ਸਕਦੇ ਹੋ।

GET /v1/astro/content/sections?lang=ta
GET /v1/astro/content/blocks?section=yogas&lang=ta&limit=100
GET /v1/astro/content/blocks?section=yogas&lang=ta&cursor=NEXT_CURSOR

ਪੱਕੀ ਨੀਂਹ ਉੱਤੇ ਬਣਾਉਟੀ ਬੁੱਧੀ ਦਾ ਵਰਣਨ

ਬਣਾਉਟੀ ਬੁੱਧੀ ਦੀਆਂ ਰਿਪੋਰਟਾਂ ਸਿਰਫ਼ ਗਿਣੀ ਗਈ ਕੁੰਡਲੀ ਅਤੇ ਜਾਂਚੇ ਫਲਾਦੇਸ਼ਾਂ ਤੋਂ ਲਿਖੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, ਫਿਰ ਤੁਹਾਡੇ ਤੱਕ ਪਹੁੰਚਣ ਤੋਂ ਪਹਿਲਾਂ ਲਿਪੀ ਅਤੇ ਸੁਰ ਲਈ ਜਾਂਚੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। ਭਾਈਵਾਲ ਸਾਡੇ ਮਾਡਲ ਵਰਤ ਸਕਦੇ ਹਨ, ਜਾਂ ਜਿੱਥੇ ਯੋਜਨਾ ਆਗਿਆ ਦੇਵੇ ਉੱਥੇ ਆਪਣੇ ਪ੍ਰਦਾਤਾ ਦੀ ਕੁੰਜੀ ਲਿਆ ਸਕਦੇ ਹਨ।

ਮਸ਼ੀਨ ਦੁਆਰਾ ਪੜ੍ਹਨਯੋਗ ਵੇਰਵਾ

ਪੂਰਾ ਵੇਰਵਾ ਉਤਾਰੋ ਅਤੇ ਆਪਣੀ ਪਸੰਦੀਦਾ ਪ੍ਰੋਗਰਾਮਿੰਗ ਭਾਸ਼ਾ ਵਿੱਚ ਗਾਹਕ ਪ੍ਰੋਗਰਾਮ ਬਣਾਓ, ਜਾਂ ਜਿਹੜਾ ਸੰਦ ਤੁਸੀਂ ਪਹਿਲਾਂ ਵਰਤਦੇ ਹੋ ਉਸ ਵਿੱਚ ਹਰ ਸੇਵਾ ਬਿੰਦੂ ਵੇਖੋ।

GET https://YOUR_HOST/v1/astro/openapi.json
GET https://YOUR_HOST/v1/astro/catalog