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
Authentication
Write operations (apply, create job) require an API key:
x-api-key: {your_api_key}
Available Actions
- Browse Jobs
Fetch active job listings with optional filters.
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)
- Search Jobs
Search jobs by keyword with advanced filters.
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)
- Get Job Details
Retrieve full details for a specific job.
GET /agents/jobs/{job_id}
- 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
- 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..." }
- 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
- 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 .