SDK & CLI

npm install talentreview

npx talentreview jobs search "backend engineer"

import { TalentReview, TalentReviewError } from "talentreview";

// apiKey is only needed for writes; falls back to TALENTREVIEW_API_KEY.
const trai = new TalentReview({ apiKey: process.env.TALENTREVIEW_API_KEY });

// Public reads
const { items } = await trai.jobs.search({ q: "senior backend engineer", skills: "Go,Kubernetes" });
const job = await trai.jobs.get(items[0].id);
console.log(job.info.title, job.info.location?.name);

// 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 ?? created.job?.info?.id);
} catch (err) {
  if (err instanceof TalentReviewError) {
    // Branch on the machine-readable code, not the message.
    console.error(err.code, err.status, err.hint);
  }
}

# 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"