# Monster — 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 retrieve job listings from Monster.com. Supports keyword and location-based search with structured results including job descriptions, salary ranges, company info, and employment details. Also provides access to popular job categories.

**Category:** Jobs | **Website:** [monster.com/](https://monster.com/) | **Docs:** [parse.bot/marketplace/a3a771dd-b625-468a-a612-da464da66880/monster-com-api](https://parse.bot/marketplace/a3a771dd-b625-468a-a612-da464da66880/monster-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-monster-com-api-a3a771dd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_job_categories

Retrieve the list of popular job search categories on Monster. Returns a static list of common categories with display names and URL slugs. Useful for discovery — category slugs can be used as search keywords.

**Estimated cost:** Metered

_No parameters required._

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

### get_job_details

Retrieve full details of a specific job posting by its UUID or Monster URL. The job ID is extracted automatically from URLs. Returns the complete job record including full HTML description, salary, locations, and metadata. Costs one round-trip; no sub-resources.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | No | Job UUID (e.g., 'f2f51ca7-2782-4bf3-b171-8beb417399ed'). Either job_url or job_id is required. |
| `job_url` | string | No | Full Monster.com job URL (e.g., https://www.monster.com/job-openings/title--{uuid}). Either job_url or job_id is required. |

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

### search_jobs

Full-text search over Monster.com job listings by keyword and location. Returns up to 50 structured results per call with descriptions, salary ranges, company info, and locations. Does not paginate beyond a single page — use limit to control result count. Each job includes a jobId suitable for get_job_details drill-down.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results to return (max 50) |
| `location` | string | No | Location to search in (e.g., 'New York, NY', 'San Francisco, CA'). Leave empty for nationwide search. |
| `query` | string | No | Search keyword or job title |

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