Endpoints

All responses are JSON. Job objects include id, title, description, organization, location, type, salary, skills, experience, and closing_date.

Browse jobs

Active listings with optional filters.

GET /agents/jobs

string

Filter by organization

string

Filter by location

string

One of full_time, part_time, contract, internship, freelance, volunteer

string

Filter by experience level

string

Comma-separated tags

string

Filter by project

integer

default:"1"

Page number

integer

default:"10"

Results per page

curl "https://api.talentreview.ai/agents/jobs?job_type=full_time&limit=5"

Search jobs

Keyword search with advanced filters.

GET /agents/jobs/search?q={query}

string

required

Search query

string

Comma-separated job types

string

Comma-separated location IDs

string

Comma-separated experience levels

string

Comma-separated skills

string

Comma-separated organization IDs

integer

default:"1"

Page number

integer

default:"10"

Results per page

curl "https://api.talentreview.ai/agents/jobs/search?q=backend%20engineer&skills=Go"

Get a job

GET /agents/jobs/{job_id}

curl "https://api.talentreview.ai/agents/jobs/01H..."

job_id must be a well-formed job id. A malformed or unknown id returns 404 not_found (see Errors).

Apply to a job

Submits an application using the authenticated user’s profile and active resume.

POST /agents/jobs/{job_id}/apply

Requires an x-api-key. The user must have an active resume on file, the job must be active, and a user cannot apply to their own posting.

curl -X POST "https://api.talentreview.ai/agents/jobs/01H.../apply" \
  -H "x-api-key: YOUR_API_KEY"

Create a job

Post a new role. Requires an x-api-key with recruiter permissions.

POST /agents/jobs

Required fields: title, organization_id, location_id, type, salary.

curl -X POST "https://api.talentreview.ai/agents/jobs" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Senior Backend Engineer",
    "description": "Build scalable APIs and services",
    "department": "Engineering",
    "location_id": "01H...",
    "type": "full_time",
    "salary": "120000-160000",
    "experience": "5+ years",
    "skills": ["Go", "PostgreSQL", "Kubernetes"],
    "organization_id": "01H...",
    "tags": ["backend"],
    "responsibilities": ["Design and build microservices"],
    "closing_date": "2026-12-31"
  }'

Resolving organization and location IDs

organization_id and location_id are required to create a job and useful as filters. Fetch valid ids from the Connect-RPC services:

curl -X POST "https://api.talentreview.ai/organization.v1.OrganizationService/List" \
  -H "Content-Type: application/json" \
  -d '{"pagination": {"pagination": {"page": 1, "limit": 50}}}'

curl -X POST "https://api.talentreview.ai/location.v1.LocationService/List" \
  -H "Content-Type: application/json" \
  -d '{"pagination": {"pagination": {"page": 1, "limit": 50}}}'

Organizations return id, name, website, industry, size, and more. Locations return id, name, is_remote, workplace_type, and a nested address.

Get started

Agent API

Browse jobs

Search jobs

Get a job

Apply to a job

Create a job

Resolving organization and location IDs

​Browse jobs

​Search jobs

​Get a job

​Apply to a job

​Create a job

​Resolving organization and location IDs

Browse jobs

Search jobs

Get a job

Apply to a job

Create a job

Resolving organization and location IDs