# Getmyfirstjob — 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 apprenticeship and early career opportunities across the UK by occupation, location, and employer. Access detailed job descriptions, employer profiles, occupation categories, and the latest apprenticeship listings from GetMyFirstJob.co.uk.

**Category:** Jobs | **Website:** [getmyfirstjob.co.uk/](https://getmyfirstjob.co.uk/) | **Docs:** [parse.bot/marketplace/753887dd-821d-4985-9405-29ff808ce1f6/getmyfirstjob-co-uk-api](https://parse.bot/marketplace/753887dd-821d-4985-9405-29ff808ce1f6/getmyfirstjob-co-uk-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-getmyfirstjob-co-uk-api-753887dd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_employers_list

Retrieve a list of employers featured on the platform with their profile page paths.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-getmyfirstjob-co-uk-api-753887dd/get_employers_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_location_filters

Retrieve available UK cities and areas with paths. These are informational location pages on the site listing apprenticeships in a specific area.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-getmyfirstjob-co-uk-api-753887dd/get_location_filters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_occupation_categories

Retrieve available occupation and industry categories with paths for filtering search_opportunities. Returns all category names and their URL paths which can be passed to search_opportunities as category_path.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-getmyfirstjob-co-uk-api-753887dd/get_occupation_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_opportunity_details

Get full details for a specific opportunity using the link path from search results. Extracts data from structured ld+json JobPosting schema and HTML metadata fields. Returns stale_input if the vacancy is no longer available or not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url_path` | string | Yes | The link path from search_opportunities results (e.g. 'opportunity/8ca49360-c5d1-4342-890e-5855283efb5f/d3dea269-2497-4b1f-8e2e-63985b5b0fdd'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-getmyfirstjob-co-uk-api-753887dd/get_opportunity_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url_path":"<string>"}'
```

### search_opportunities

Search for apprenticeship and early career opportunities. Returns listings from the main search page or a specific occupation category page. An optional keyword filter is applied client-side to the returned results. Without category_path, returns all listings from the main search page (up to 10 SSR-rendered results). With category_path, returns listings for that specific occupation category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | No | Category path from get_occupation_categories results (e.g. 'discover-opportunities/occupation-categories/details/computing-technology-and-digital/5'). When provided, fetches listings for that category. |
| `query` | string | No | Keyword to filter results by title, description, employer, or category. Applied client-side to the pre-rendered listings. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-getmyfirstjob-co-uk-api-753887dd/search_opportunities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_path":"<string>","query":"<string>"}'
```