# Jobs Vodafone — 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 explore current Vodafone job openings, view detailed position information, discover similar roles, and gain insights about career opportunities across the company. Find the total number of available jobs and get relevant data to support your job search and career planning at Vodafone.

**Category:** Jobs | **Website:** [jobs.vodafone.com/](https://jobs.vodafone.com/) | **Docs:** [parse.bot/marketplace/830e8676-6521-4d45-b150-3febc4ddcb54/jobs-vodafone-com-api](https://parse.bot/marketplace/830e8676-6521-4d45-b150-3febc4ddcb54/jobs-vodafone-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/jobs-vodafone/`
**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 insights

Returns skill relevance scores and comparable job-title frequencies for a given position. Skills map skill-name to an integer relevance score; titles map title-name to frequency count. Useful for understanding what competencies a role requires relative to the broader market.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | Numeric job ID to get insights for (from search_jobs results positions[*].id). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/jobs-vodafone/get-job-insights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"<string>"}'
```

### Get similar positions

Returns up to 10 positions similar to the given job ID, based on the Eightfold matching engine. Useful for discovering related opportunities from any position found via search_jobs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | Numeric job ID to find similar positions for (from search_jobs results positions[*].id). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/jobs-vodafone/get-similar-positions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"<string>"}'
```

### Get total job count

Returns the total count of active Vodafone job listings matching optional keyword and location filters. Lightweight alternative to search_jobs when only the count is needed — no position data returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location to filter jobs by. |
| `query` | string | No | Keyword to filter jobs by. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/jobs-vodafone/get-total-job-count \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","query":"<string>"}'
```

### Search jobs

Full-text search across all Vodafone job openings. Matches query against job titles and descriptions, filterable by location. Returns 10 positions per page; paginate via the start offset (multiples of 10). Each position includes department, work-location option (hybrid/onsite/remote), posting timestamp, and a URL path for the full listing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location filter (city, country, etc.). Example: 'London, United Kingdom'. |
| `query` | string | No | Keyword to search for in job titles and descriptions. |
| `sort_by` | string | No | Sort order for results. |
| `start` | integer | No | Pagination offset in multiples of 10 (0, 10, 20, ...). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/jobs-vodafone/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","query":"<string>","sort_by":"<string>","start":"<integer>"}'
```

## 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.