SDK

Typed TypeScript client for the Veezee REST API. Zero runtime dependencies, built on Node 20's global fetch.

Install

npm install @veezee/sdk

Node 20+ required.

Quickstart

import { VeezeeClient } from "@veezee/sdk";

const client = new VeezeeClient(); const { common } = await client.provision(); // free trial key, shown once const profile = await client.getProfile({ identifier: "williamhgates" }); ```

Already have a key? new VeezeeClient({ apiKey: process.env.VEEZEE_API_KEY }).

The seven methods

provision, resolveUrl, getProfile, searchPeople, getCompany, getPosts, getUsage: one method per tool, same names and envelopes as the REST contract (https://veezee.io/openapi.json). Every response carries usage with the receipt id, credits charged, and balance.

Retries and idempotency

The client retries RATE_LIMITED, CONCURRENCY_LIMIT, UPSTREAM_UNAVAILABLE, INTERNAL, and network failures up to 3 attempts with backoff, honoring retry_after_seconds. Each metered call gets one Idempotency-Key reused across its own retries, so retries never double-charge. Terminal errors throw VeezeeError with the same code/message/param shape the API returns.