# Monster India — 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 Foundit (Monster India) to find opportunities in popular cities and top locations, then view detailed information about specific jobs. Access real-time job data across various sectors and locations to compare positions and make informed career decisions.

**Category:** Jobs | **Website:** [monsterindia.com/](https://monsterindia.com/) | **Docs:** [parse.bot/marketplace/25833cf2-d2de-4750-b6e9-925657ba666b/monsterindia-com-api](https://parse.bot/marketplace/25833cf2-d2de-4750-b6e9-925657ba666b/monsterindia-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-monsterindia-com-api-25833cf2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_job_details

Retrieve full details for a single job listing by its numeric ID. Returns comprehensive information including HTML description, company details, salary, skills, similar jobs, related articles, and view count. The job ID is obtained from search_jobs results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | Unique numeric ID of the job listing (from search_jobs results[*].id). |

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

### get_popular_cities

Returns the list of popular cities and locations available on the platform. Useful for populating location filter dropdowns in search_jobs. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-monsterindia-com-api-25833cf2/get_popular_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_top_locations

Returns the list of top locations on the platform. Returns the same location set as get_popular_cities, useful for populating location filter dropdowns.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-monsterindia-com-api-25833cf2/get_top_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_jobs

Full-text search over foundit.in job listings. query matches job titles, skills, and company names. Results paginate via offset; each page returns up to limit items. Filters narrow by location, experience level, and posting freshness. Returns job summaries with id, title, company, locations, experience range, salary, and skills.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `experience` | integer | No | Minimum years of experience required for the job. |
| `freshness` | integer | No | Filter jobs posted within this many days. Accepted values: 1, 3, 7, 15, or 30. |
| `limit` | integer | No | Number of results to return per page. |
| `location` | string | No | City or location name to filter results (e.g. 'Bengaluru', 'Mumbai', 'Delhi NCR', 'Remote'). |
| `offset` | integer | No | Offset for pagination (number of results to skip). |
| `query` | string | Yes | Search keywords matching job titles, skills, or company names. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-monsterindia-com-api-25833cf2/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"experience":"<integer>","freshness":"<integer>","limit":"<integer>","location":"<string>","offset":"<integer>","query":"<string>"}'
```