# Timesjobs — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse job listings from TimesJobs.com to find positions by role, category, and company, while discovering popular job roles, featured employers, and detailed job information. Filter opportunities using available facets and explore career statistics to match your skills with the right opportunities.

**Category:** Jobs | **Website:** [timesjobs.com/](https://timesjobs.com/) | **Docs:** [parse.bot/marketplace/2aaff4b4-cafc-4786-8f92-1ab997ddbc1a/timesjobs-com-api](https://parse.bot/marketplace/2aaff4b4-cafc-4786-8f92-1ab997ddbc1a/timesjobs-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-timesjobs-com-api-2aaff4b4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_facets

Retrieve search facets (available filter options with counts) for a given keyword and location combination. Returns facet arrays for job function, location, industry, and experience level. Useful for building filter UIs or understanding the distribution of jobs matching a query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | No | Keyword to get facets for (e.g. 'python'). Omitting returns facets for all jobs. |
| `location` | string | No | Location to filter facets by (e.g. 'bangalore'). Omitting returns facets for all locations. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timesjobs-com-api-2aaff4b4/get_facets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"<string>","location":"<string>"}'
```

### get_featured_companies

Retrieve featured companies currently hiring with job counts. Returns companies such as nVIDIA, Adobe, and Mastercard with their logos and job counts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timesjobs-com-api-2aaff4b4/get_featured_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_job_categories

Retrieve job categories (functional areas) with current job counts. Returns categories such as Freshers, IT, Sales & Marketing, Operations, Manufacturing, HR, and Banking & Finance.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timesjobs-com-api-2aaff4b4/get_job_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_job_detail

Retrieve full details for a specific job by its encoded ID. Returns comprehensive information including HTML description, skills, qualifications, company details, locations, employment type, and application links. The job_id is found in search_jobs results as the encoded portion of jobDetailUrl or directly as jobId.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | Encoded job ID from search_jobs results (found in jobDetailUrl path or as jobId field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timesjobs-com-api-2aaff4b4/get_job_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"<string>"}'
```

### get_popular_roles

Retrieve popular job roles with current job counts. Returns roles such as Java Developer, Software Engineer, Data Engineer, Project Manager, and others.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timesjobs-com-api-2aaff4b4/get_popular_roles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_jobs

Full-text search over job listings by keyword, location, and experience level. Returns paginated results with job summaries including title, company, location, skills, salary range, and posting dates. Each job carries a jobId usable with get_job_detail for the full listing. Paginates via integer page counter; server default is 10 results per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `experience` | string | No | Minimum years of experience filter (e.g. '3'). Omitting returns jobs for all experience levels. |
| `keyword` | string | No | Search keyword (e.g. 'python', 'java developer'). Omitting returns all jobs. |
| `location` | string | No | Location filter (e.g. 'bangalore', 'mumbai'). Omitting returns jobs from all locations. |
| `page` | integer | No | Page number for pagination. |
| `size` | integer | No | Number of results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timesjobs-com-api-2aaff4b4/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"experience":"<string>","keyword":"<string>","location":"<string>","page":"<integer>","size":"<integer>"}'
```