# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/getmyfirstjob/`
**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 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/credits/getmyfirstjob/get-employers-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/getmyfirstjob/get-location-filters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/getmyfirstjob/get-occupation-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/getmyfirstjob/get-opportunity-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/getmyfirstjob/search-opportunities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_path":"<string>","query":"<string>"}'
```

## Next steps

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