# Jobs Apple — 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 open positions at Apple by keywords, location, and role, then view detailed job descriptions and requirements. Use autocomplete features to quickly find specific locations and job categories that match your career interests.

**Category:** Jobs | **Website:** [jobs.apple.com/en-us/search/?location\=united-states-USA\&team\=computer-vision-MLAI-CV](https://jobs.apple.com/en-us/search/?location\=united-states-USA\&team\=computer-vision-MLAI-CV) | **Docs:** [parse.bot/marketplace/268e47f7-3fcc-4107-b39c-4b9b9d9392f9/jobs-apple-com-api](https://parse.bot/marketplace/268e47f7-3fcc-4107-b39c-4b9b9d9392f9/jobs-apple-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-apple/`
**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

Fetch the full detail record of a single Apple job posting by its composite ID (from search_jobs results). Includes the complete description, qualifications, pay range, team membership, and location details not present in search summaries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | Job ID from search_jobs results (e.g. '200657324-0836'). |
| `locale` | string | No | Locale code. |

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

### Quickfind

Autocomplete job titles from current Apple listings. Returns up to 10 title suggestions matching the partial input. Useful for discovering exact job titles before running a full search.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial job title to autocomplete (e.g. 'software', 'data sci'). |

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

### Search jobs

Full-text search over Apple job listings. `query` matches title and summary; `sort` orders results by relevance, newest, or oldest. Location filtering uses IDs from search_locations (e.g. 'SFMETRO'). Returns 20 results per page. Each job summary includes title, team, posting date, and locations but not full description — use get_job_details for that.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `locale` | string | No | Locale code (e.g. 'en-us'). |
| `location` | string | No | Location filter ID(s), comma-separated. Use search_locations to find valid IDs. Can use full ID like 'postLocation-SFMETRO' or short code like 'SFMETRO'. |
| `page` | integer | No | Page number (1-based). |
| `query` | string | No | Search keyword (e.g. 'machine learning', 'software engineer'). Empty string returns all jobs. |
| `sort` | string | No | Sort order. |

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

### Search locations

Search for Apple office location IDs by name. Returns matching locations with their codes suitable for use as the `location` filter in search_jobs. Useful for discovering the correct location code before filtering job searches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Location search term (e.g. 'San Francisco', 'London', 'New York'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/jobs-apple/search-locations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"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.