talentreview-jobs

Original：🇺🇸 English

Translated

Job discovery and application skill for TalentReview.ai. Search listings, browse opportunities, apply to roles, and post new jobs via natural language.

1installs

Sourcetalentreview-ai/talentreviewai-skills

Added on2026-02-10

NPX Install

npx skill4agent add talentreview-ai/talentreviewai-skills talentreview-jobs

SKILL.md Content

View Translation Comparison →

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

text

https://api.talentreview.ai

Authentication

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

text

x-api-key: {your_api_key}

Available Actions

1. Browse Jobs

Fetch active job listings with optional filters.

text

GET /agents/jobs

Parameters (all optional):

Parameter	Description
`project_id`	Filter by project
`organization_id`	Filter by organization
`location_id`	Filter by location
`experience`	Filter by experience level
`job_type`	`full_time` , `part_time` , `contract` , `internship` , `freelance` , `volunteer`
`hashtags`	Comma-separated tags
`page`	Page number (default: 1)
`limit`	Results per page (default: 10)

2. Search Jobs

Search jobs by keyword with advanced filters.

text

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

Parameters:

Parameter	Required	Description
`q`	Yes	Search query
`job_types`	No	Comma-separated job types
`location_ids`	No	Comma-separated location IDs
`experiences`	No	Comma-separated experience levels
`skills`	No	Comma-separated skills
`organization_ids`	No	Comma-separated organization IDs
`page`	No	Page number (default: 1)
`limit`	No	Results per page (default: 10)

3. Get Job Details

Retrieve full details for a specific job.

text

GET /agents/jobs/{job_id}

4. Apply to Job

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

text

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).

text

POST /agents/jobs

Required Fields:

title

,

organization_id

,

location_id

,

type

,

salary

Request Body:

json

{
  "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.

text

POST /organization.v1.OrganizationService/List

Request Body:

json

{
  "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.

text

POST /location.v1.LocationService/List

Request Body:

json

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

.

talentreview-jobs

NPX Install

Tags

SKILL.md Content

TalentReview.ai Job Discovery & Application

When to Use

Base URL

Authentication

Available Actions

1. Browse Jobs

2. Search Jobs

3. Get Job Details

4. Apply to Job

5. Create Job Listing

6. List Organizations

7. List Locations

Response Format