TalentReview.ai Job Discovery & Application

Find and apply to jobs through the TalentReview.ai platform.

When to Use

• User wants to search or browse job listings
• User wants to apply to a job position
• User wants to post/create a new job listing
• User asks about available job opportunities

Base URL

https://api.talentreview.ai

Authentication

Write operations (apply, create job) require an API key:

x-api-key: {your_api_key}

Available Actions

1. Browse Jobs

Fetch active job listings with optional filters.

GET /agents/jobs

Parameters (all optional):

2. Search Jobs

Search jobs by keyword with advanced filters.

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

Parameters:

3. Get Job Details

Retrieve full details for a specific job.

GET /agents/jobs/{job_id}

4. Apply to Job

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

POST /agents/jobs/{job_id}/apply

Requirements:

• Valid API key in x-api-key header
• User must have an active resume on file
• Job must be active
• User cannot apply to their own job posting

5. Create Job Listing

Post a new job opportunity (requires recruiter permissions).

POST /agents/jobs

Required Fields: title, organization_id, location_id, type, salary

Request Body:

{
  "title": "Senior Backend Engineer",
  "description": "Build scalable APIs and services",
  "department": "Engineering",
  "location_id": "01H...",
  "type": "full_time",
  "salary": "120000-160000",
  "experience": "5+ years",
  "education": "BS in Computer Science",
  "skills": ["Go", "PostgreSQL", "Kubernetes"],
  "team": "Platform",
  "reporting_to": "Engineering Manager",
  "closing_date": "2026-12-31",
  "organization_id": "01H...",
  "tags": ["backend", "distributed-systems"],
  "responsibilities": ["Design and build microservices"],
  "resume_score_threshold": 0.7,
  "generate_screening": true,
  "project_id": "01H..."
}

6. List Organizations

Fetch a paginated list of organizations (companies) whose IDs can be used as organization_id when browsing, searching, or creating jobs.

POST /organization.v1.OrganizationService/List

Request Body:

{
  "pagination": {
    "pagination": {
      "page": 1,
      "limit": 50
    }
  }
}

Response:

• organizations: array of organizations with fields such as id, name, avatar, description, website, industry, size, founded_year
• pagination: standard pagination metadata with current_page, total_pages, and total_items

7. List Locations

Fetch a paginated list of locations whose IDs can be used as location_id when browsing, searching, or creating jobs.

POST /location.v1.LocationService/List

Request Body:

{
  "pagination": {
    "pagination": {
      "page": 1,
      "limit": 50
    }
  }
}

Response:

• locations: array of locations with fields such as id, name, is_remote, workplace_type, and nested address (including address_country, address_region, address_locality, postal_code, street_address)
• pagination: standard pagination metadata with current_page, total_pages, and total_items

Response Format

All responses return JSON. Job listings include: id, title, description, organization, location, type, salary, skills, experience, and closing_date.