Back to Details

talentreview-jobs

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

TalentReview.ai Job Discovery & Application

TalentReview.ai 职位发现与申请

Find and apply to jobs through the TalentReview.ai platform.
通过TalentReview.ai平台查找并申请职位。

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

基础URL

text
https://api.talentreview.ai
text
https://api.talentreview.ai

Authentication

身份验证

Write operations (apply, create job) require an API key:
text
x-api-key: {your_api_key}
写入操作（申请职位、创建职位）需要API密钥：
text
x-api-key: {your_api_key}

Available Actions

可用操作

1. Browse Jobs

1. 浏览职位

Fetch active job listings with optional filters.
text
GET /agents/jobs
Parameters (all optional):
ParameterDescription
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)
获取带有可选筛选条件的活跃职位列表。
text
GET /agents/jobs
参数（均为可选）：
参数说明
project_id
按项目筛选
organization_id
按组织筛选
location_id
按地点筛选
experience
按经验水平筛选
job_type
full_time
, 
part_time
, 
contract
, 
internship
, 
freelance
, 
volunteer
hashtags
逗号分隔的标签
page
页码（默认值：1）
limit
每页结果数（默认值：10）

2. Search Jobs

2. 搜索职位

Search jobs by keyword with advanced filters.
text
GET /agents/jobs/search?q={query}
Parameters:
ParameterRequiredDescription
q
YesSearch query
job_types
NoComma-separated job types
location_ids
NoComma-separated location IDs
experiences
NoComma-separated experience levels
skills
NoComma-separated skills
organization_ids
NoComma-separated organization IDs
page
NoPage number (default: 1)
limit
NoResults per page (default: 10)
通过关键词搜索职位，并支持高级筛选。
text
GET /agents/jobs/search?q={query}
参数：
参数是否必填说明
q
是搜索关键词
job_types
否逗号分隔的职位类型
location_ids
否逗号分隔的地点ID
experiences
否逗号分隔的经验水平
skills
否逗号分隔的技能
organization_ids
否逗号分隔的组织ID
page
否页码（默认值：1）
limit
否每页结果数（默认值：10）

3. Get Job Details

3. 获取职位详情

Retrieve full details for a specific job.
text
GET /agents/jobs/{job_id}
获取特定职位的完整详情。
text
GET /agents/jobs/{job_id}

4. Apply to Job

4. 申请职位

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
使用已认证用户的个人资料和有效简历提交申请。
text
POST /agents/jobs/{job_id}/apply
要求：
  • 请求头中需包含有效的API密钥 
    x-api-key
  • 用户必须有有效的简历存档
  • 职位必须处于活跃状态
  • 用户不能申请自己发布的职位

5. Create Job Listing

5. 创建职位列表

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..."
}
发布新的职位机会（需要招聘者权限）。
text
POST /agents/jobs
必填字段：
title
、
organization_id
、
location_id
、
type
、
salary
请求体：
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

6. 列出组织

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
获取组织（公司）的分页列表，其ID可在浏览、搜索或创建职位时用作 
organization_id
。
text
POST /organization.v1.OrganizationService/List
请求体：
json
{
  "pagination": {
    "pagination": {
      "page": 1,
      "limit": 50
    }
  }
}
响应：
  • organizations
    : 组织数组，包含
    id
    、
    name
    、
    avatar
    、
    description
    、
    website
    、
    industry
    、
    size
    、
    founded_year
    等字段
  • pagination
    : 标准分页元数据，包含
    current_page
    、
    total_pages
    和
    total_items

7. List Locations

7. 列出地点

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
获取地点的分页列表，其ID可在浏览、搜索或创建职位时用作 
location_id
。
text
POST /location.v1.LocationService/List
请求体：
json
{
  "pagination": {
    "pagination": {
      "page": 1,
      "limit": 50
    }
  }
}
响应：
  • locations
    : 地点数组，包含
    id
    、
    name
    、
    is_remote
    、
    workplace_type
    以及嵌套的
    address
    （包括
    address_country
    、
    address_region
    、
    address_locality
    、
    postal_code
    、
    street_address
    ）等字段
  • pagination
    : 标准分页元数据，包含
    current_page
    、
    total_pages
    和
    total_items

Response Format

响应格式

All responses return JSON. Job listings include: 
id
, 
title
, 
description
, 
organization
, 
location
, 
type
, 
salary
, 
skills
, 
experience
, and 
closing_date
.
所有响应均返回JSON格式。职位列表包含：
id
、
title
、
description
、
organization
、
location
、
type
、
salary
、
skills
、
experience
和
closing_date
。