@askvedicguru/sdk

Official TypeScript/JavaScript SDK for AskVedicGuru — Vedic astrology data and AI insights via one API.

Install

npm install @askvedicguru/sdk
# or
bun add @askvedicguru/sdk

Works in Node.js 18+, Bun, Deno, and any environment with Fetch API support.

Quick start

import { AskVedicGuru } from '@askvedicguru/sdk'

const guru = new AskVedicGuru({
  apiKey: process.env.ASKVEDICGURU_API_KEY!,
})

// List profiles and get a birth chart
const profiles = await guru.profiles.list()
const chart = await guru.chart.full(profiles[0].id)
console.log(chart.moonSign)

Core resources

| Resource | Methods | |----------|---------| | guru.profiles | list(), create() | | guru.chart | full(), basicDetails(), planets(), ascendant(), nakshatra(), elements(), personality() | | guru.panchang | get(), rashi() | | guru.rashifal | get(), allSigns() | | guru.dasha | get() | | guru.predictions | get(), dailyInsight(), transits() | | guru.dosha | get(), sadeSati(), remedies() | | guru.strength | yogas(), ashtakavarga(), shadbala(), houseLords(), atmakaraka(), functional() | | guru.conjunctions | get(), aspects(), vargas() | | guru.chat | send() — AI Guru | | guru.apiKeys | list(), create(), revoke() | | guru.reports | kundli(), predictions(), compatibility() — returns PDF ArrayBuffer |

Error handling

import {
  AskVedicGuru,
  AuthenticationError,
  InsufficientCreditsError,
  PlanRequiredError,
  RateLimitError,
} from '@askvedicguru/sdk'

try {
  const chart = await guru.chart.full(profileId)
} catch (err) {
  if (err instanceof InsufficientCreditsError) {
    console.error('Out of credits')
  } else if (err instanceof RateLimitError) {
    console.error(`Retry after ${err.retryAfter}s`)
  } else if (err instanceof PlanRequiredError) {
    console.error('Upgrade required')
  }
}

Full documentation

→ docs.askvedicguru.com