timesjobs.com APItimesjobs.com ↗
Search and retrieve job listings, categories, featured companies, and role statistics from TimesJobs.com via a structured REST API with 6 endpoints.
curl -X GET 'https://api.parse.bot/scraper/0053796a-6939-498b-aa1e-50a128c767e4/search_jobs?page=1&size=10&keyword=python' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for job listings by keyword, location, and experience. Returns paginated results with job summaries including title, company, location, skills, salary range, and posting dates.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| size | integer | Number of results per page. |
| keyword | string | Search keyword (e.g. 'python', 'java developer'). Omitting returns all jobs. |
| location | string | Search location (e.g. 'bangalore', 'mumbai'). Omitting returns jobs from all locations. |
| experience | string | Minimum years of experience filter (e.g. '3'). Omitting returns jobs for all experience levels. |
{
"type": "object",
"fields": {
"jobs": "array of job objects with title, company, location, skills, jobId, postDate, expiryDate, experienceFrom, experienceTo, lowSalary, highSalary, jobType, jobFunction, description, companyLogo, jobDetailUrl",
"page": "integer, current page number",
"size": "integer, results per page",
"total": "integer, total number of matching jobs",
"totalPages": "number, total number of pages"
},
"sample": {
"data": {
"jobs": [
{
"jobId": "80369699",
"title": "Python Developer",
"skills": "Python Development API Design Database Management",
"company": "Nextbrain",
"jobType": "On-site",
"location": "Bengaluru",
"postDate": "2026-04-26",
"lowSalary": -1,
"highSalary": -1,
"description": "Qualification Any Degree Experience 3 Years...",
"jobFunction": "IT Software : Software Products & Services",
"experienceTo": 6,
"experienceFrom": 3
}
],
"page": 1,
"size": 10,
"total": 32149,
"totalPages": 3215
},
"status": "success"
}
}About the timesjobs.com API
The TimesJobs API gives developers structured access to job listings and recruiting data from TimesJobs.com across 6 endpoints. Use search_jobs to query by keyword, location, and experience level and receive paginated results with salary ranges, required skills, and posting dates. Additional endpoints expose full job descriptions, job categories with live counts, popular roles, featured employers, and dynamic search facets.
Search and Job Details
The search_jobs endpoint accepts keyword, location, and experience parameters and returns paginated job summaries. Each item in the jobs array includes title, company, location, skills, jobId, postDate, expiryDate, experienceFrom, experienceTo, lowSalary, along with pagination metadata (page, size, total, totalPages). The get_job_detail endpoint takes the encoded job_id from those results and returns the full record: an HTML-formatted description, locationNames array, experience range, jobType (e.g. On-site), postedAt, expiresAt, and companyName.
Market Statistics and Discovery
Three endpoints return current aggregate statistics without requiring any inputs. get_job_categories returns functional-area categories such as IT, HR, and Banking & Finance, each with a name, count, logo, and url. get_popular_roles lists trending roles like Java Developer and Data Engineer with current count values. get_featured_companies returns companies actively hiring — including Amazon, Adobe, and Mastercard — with per-company count, logo, and direct url fields.
Faceted Filtering
The get_facets endpoint accepts an optional keyword and location and returns filter breakdowns across four dimensions: Jobfunction, Location, IndustryValue, and ExperienceCode. Each facet entry carries a value and count, making it straightforward to build dynamic filter UI or to pre-screen which parameter combinations will return non-empty search_jobs results before issuing the full query.
- Aggregate India-focused job listings by role and location for a job board or aggregator site.
- Track hiring trends for specific skills (e.g. 'python', 'java') over time using
search_jobsresult counts. - Display company hiring activity dashboards using
get_featured_companiesname, count, and logo fields. - Build a role-demand index by polling
get_popular_rolescounts across multiple periods. - Power faceted job-search UI with live filter counts from
get_facetsbefore executing the full search. - Alert users when new listings match saved keyword and location queries by monitoring
totalandpostDatefields. - Enrich candidate-facing tools with full job descriptions and skill requirements via
get_job_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TimesJobs have an official developer API?+
What does get_job_detail return beyond what search_jobs shows?+
get_job_detail endpoint returns the full HTML-formatted description, the numeric jobId, jobType (e.g. On-site), ISO datetime fields postedAt and expiresAt, a locationNames array for multi-location roles, and the experience range as a formatted string. The search_jobs endpoint returns summaries only, so description and jobType are available exclusively through get_job_detail.How does pagination work in search_jobs?+
search_jobs endpoint accepts page (zero- or one-indexed integer) and size (results per page) parameters. The response includes total (total matching jobs) and totalPages so callers can iterate through the full result set. Omitting page defaults to the first page.Does the API return salary data for all jobs?+
lowSalary field returned in search_jobs summaries. Many listings on TimesJobs do not disclose compensation, so lowSalary may be absent or null for a significant portion of results. A highSalary field is not currently part of the response. You can fork the API on Parse and revise it to add a salary range endpoint if the source exposes that data elsewhere.Can I filter search results by job category or industry directly?+
search_jobs endpoint currently filters by keyword, location, and experience only. Category or industry filtering is not a direct parameter. The get_facets endpoint returns Jobfunction and IndustryValue breakdowns with counts, which can guide keyword choice. You can fork the API on Parse and revise it to add category or industry as a direct search_jobs filter parameter.