TalentReviewAI SDK & CLI

Official TypeScript SDK and command-line tool for the TalentReviewAI Agent API: search, read, apply to, and create jobs.

Full API docs: https://docs.talentreview.ai

Install

npm install talentreview

Or run the CLI without installing:

npx talentreview jobs search "backend engineer"

SDK

import { TalentReview, TalentReviewError } from "talentreview";

const trai = new TalentReview({
  // apiKey is only needed for writes (apply, create).
  // Falls back to the TALENTREVIEW_API_KEY env var.
  apiKey: process.env.TALENTREVIEW_API_KEY,
});

// Public reads
const { jobs } = await trai.jobs.search({ q: "senior backend engineer", skills: "Go,Kubernetes" });
const job = await trai.jobs.get(jobs[0].id);

// Writes (require an API key)
try {
  const created = await trai.jobs.create({
    title: "Senior Backend Engineer",
    organization_id: "01H...",
    location_id: "01H...",
    type: "full_time",
    salary: "120000-160000",
    skills: ["Go", "PostgreSQL"],
  });
  console.log(created.id);
} catch (err) {
  if (err instanceof TalentReviewError) {
    // Branch on the machine-readable code, not the message.
    console.error(err.code, err.status, err.hint);
  }
}

Methods

| Method | Auth | Description | | --- | --- | --- | | jobs.list(params?) | – | Browse active jobs with optional filters | | jobs.search(params) | – | Keyword search | | jobs.get(id) | – | Get one job | | jobs.apply(id) | API key | Apply using the key owner's profile and resume | | jobs.create(body) | API key | Post a new job |

Errors reject with a TalentReviewError carrying code, status, message, and an optional hint.

CLI

# Public
talentreview jobs list --type full_time --limit 5
talentreview jobs search "product designer" --skills Figma
talentreview jobs get 01H... --json
talentreview jobs get 01H... --markdown

# Writes (need a key)
export TALENTREVIEW_API_KEY=sk_...
talentreview jobs apply 01H...
talentreview jobs create --title "Backend Engineer" --org 01H... --location 01H... --type full_time --salary "120k-160k"

Global flags: --json (raw JSON output, for agents/scripts), --api-key <key>, --base-url <url>. The binary is also available as trai.

Configuration

| Env var | Purpose | | --- | --- | | TALENTREVIEW_API_KEY | API key for write operations | | TALENTREVIEW_BASE_URL | Override the API base URL (default https://api.talentreview.ai) |

License

MIT