# Monster India — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/monster-india/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/monster-india/get-job-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/monster-india/get-popular-cities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/monster-india/get-top-locations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/monster-india/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"experience":"<integer>","freshness":"<integer>","limit":"<integer>","location":"<string>","offset":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.