# Jobs Apple — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-jobs-apple-com-api-268e47f7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-jobs-apple-com-api-268e47f7/get_job_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-jobs-apple-com-api-268e47f7/quickfind \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-jobs-apple-com-api-268e47f7/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-jobs-apple-com-api-268e47f7/search_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```