The agent that turns websites into APIs!
Apple Jobs API - Reverse Engineered Client
This directory contains a reverse-engineered Python client for the Apple Jobs API, extracted from HAR file analysis.
π API Overview
The Apple Jobs API provides programmatic access to job listings on jobs.apple.com. The API uses a simple REST architecture with JSON payloads.
Base URL
https://jobs.apple.com/api/v1
π Discovered Endpoints
1. GET /api/v1/CSRFToken
Purpose: Obtain a CSRF token required for search requests
Authentication: None required (creates session cookies)
Request Headers:
- Standard browser headers
browserlocale: e.g., "en-us", "fr-fr"locale: e.g., "EN_US", "FR_FR"
Response:
- Status: 200 OK
- Headers:
x-apple-csrf-token: The CSRF token (required for POST requests)set-cookie: Session cookies (jobs,jssid,AWSALBAPP-*)
Example:
curl -X GET 'https://jobs.apple.com/api/v1/CSRFToken' \
-H 'browserlocale: en-us' \
-H 'locale: EN_US'
2. POST /api/v1/search
Purpose: Search for job postings with filters and pagination
Authentication:
- Requires CSRF token in
x-apple-csrf-tokenheader - Requires session cookies from CSRFToken endpoint
Request Headers:
Content-Type: application/jsonx-apple-csrf-token: Token from CSRFToken endpointbrowserlocale: Locale string (e.g., "en-us")locale: Uppercase locale with underscore (e.g., "EN_US")Origin: https://jobs.apple.comReferer: https://jobs.apple.com/[locale]/search
Request Body:
{
"query": "",
"filters": {},
"page": 1,
"locale": "en-us",
"sort": "",
"format": {
"longDate": "MMMM D, YYYY",
"mediumDate": "MMM D, YYYY"
}
}
Request Parameters:
query(string): Search term for job title/descriptionfilters(object): Filter criteria (location, team, role, etc.)page(integer): Page number (1-indexed)locale(string): Locale for results (e.g., "en-us", "fr-fr")sort(string): Sort order (empty for default)format(object): Date format preferences
Response:
{
"res": {
"searchResults": [
{
"id": "PIPE-200125391",
"positionId": "200125391",
"postingTitle": "Software Engineer",
"postingDate": "Dec 22, 2025",
"jobSummary": "Job description text...",
"locations": [
{
"postLocationId": "postLocation-USA",
"city": "Cupertino",
"stateProvince": "California",
"countryName": "United States",
"metro": "",
"region": "",
"name": "Cupertino",
"countryID": "iso-country-USA",
"level": 3
}
],
"team": {
"teamName": "Software Engineering",
"teamID": "teamsAndSubTeams-SFTWR",
"teamCode": "SFTWR"
},
"reqId": "PIPE-200125391",
"standardWeeklyHours": 40,
"homeOffice": false,
"isMultiLocation": false,
"transformedPostingTitle": "software-engineer"
}
],
"totalRecords": 6178,
"talentLimitDetails": {},
"talentRolesInfoById": {}
}
}
Response Fields:
searchResults: Array of job objectsid: Unique job identifierpositionId: Position ID (used in job URLs)postingTitle: Job titlepostingDate: Date the job was postedjobSummary: Full job descriptionlocations: Array of location objectsteam: Team/department informationtransformedPostingTitle: URL-friendly titlestandardWeeklyHours: Expected weekly hourshomeOffice: Whether remote work is available
totalRecords: Total number of matching jobs
Job URL Format:
https://jobs.apple.com/en-us/details/{positionId}/{transformedPostingTitle}
Example:
curl -X POST 'https://jobs.apple.com/api/v1/search' \
-H 'Content-Type: application/json' \
-H 'x-apple-csrf-token: YOUR_CSRF_TOKEN' \
-H 'browserlocale: en-us' \
-H 'locale: EN_US' \
-H 'Cookie: jobs=...; jssid=...' \
-d '{
"query": "engineer",
"filters": {},
"page": 1,
"locale": "en-us",
"sort": "",
"format": {
"longDate": "MMMM D, YYYY",
"mediumDate": "MMM D, YYYY"
}
}'
π Authentication Flow
Get CSRF Token:
- Call
GET /api/v1/CSRFToken - Extract token from
x-apple-csrf-tokenresponse header - Save session cookies (
jobs,jssid,AWSALBAPP-*)
- Call
Make Search Requests:
- Include CSRF token in
x-apple-csrf-tokenheader - Include session cookies in requests
- All POST requests require the CSRF token
- Include CSRF token in
π¦ Python Client Usage
Installation
The client requires only the requests library:
pip install requests
Basic Usage
from api_client import AppleJobsAPI
# Initialize the client
client = AppleJobsAPI(locale="en-us")
# Search for jobs
jobs = client.search_jobs(query="engineer", page=1)
# Print job details
for job in jobs:
print(f"Title: {job.postingTitle}")
print(f"Location: {job.locations[0].name if job.locations else 'N/A'}")
print(f"URL: {job.url}")
print(f"Description: {job.jobSummary[:100]}...")
print("-" * 80)
Advanced Usage
# Get total number of jobs
total = client.get_total_jobs(query="software")
print(f"Total software jobs: {total}")
# Search with filters (example structure)
filtered_jobs = client.search_jobs(
query="engineer",
filters={
"postLocation": ["postLocation-USA"],
"team": ["teamsAndSubTeams-SFTWR"]
},
page=1
)
# Get all jobs with pagination
all_jobs = client.search_all_jobs(
query="data scientist",
max_pages=10 # Limit to first 10 pages
)
print(f"Fetched {len(all_jobs)} total jobs")
Extracting Specific Fields
The user requested: URL, Title, Location, Description
# Get jobs and extract requested fields
jobs = client.search_jobs(query="", page=1)
for job in jobs:
data = {
"url": job.url,
"title": job.postingTitle,
"location": job.locations[0].name if job.locations else "N/A",
"description": job.jobSummary
}
print(data)
Output to CSV
import csv
jobs = client.search_all_jobs(max_pages=5)
with open('apple_jobs.csv', 'w', newline='', encoding='utf-8') as f:
writer = csv.DictWriter(f, fieldnames=['url', 'title', 'location', 'description'])
writer.writeheader()
for job in jobs:
writer.writerow({
'url': job.url,
'title': job.postingTitle,
'location': job.locations[0].name if job.locations else 'N/A',
'description': job.jobSummary
})
print(f"Exported {len(jobs)} jobs to apple_jobs.csv")
π Data Structure
Job Object
Each job contains the following key information:
| Field | Type | Description |
|---|---|---|
id |
string | Unique job identifier |
positionId |
string | Position ID (used in URLs) |
postingTitle |
string | Job title |
postingDate |
string | Date posted |
jobSummary |
string | Full job description |
locations |
array | Array of location objects |
team |
object | Team/department info |
standardWeeklyHours |
integer | Expected weekly hours |
homeOffice |
boolean | Remote work available |
url |
string | Generated job URL |
Location Object
| Field | Type | Description |
|---|---|---|
name |
string | Location name |
city |
string | City name |
stateProvince |
string | State/province |
countryName |
string | Country name |
countryID |
string | ISO country code |
π― Common Use Cases
1. Get All Jobs in a Specific Location
# Note: You'll need to discover the correct location ID
jobs = client.search_jobs(
filters={"postLocation": ["postLocation-FRA"]}, # France
page=1
)
2. Search by Keyword
engineering_jobs = client.search_jobs(query="software engineer")
3. Fetch All Available Jobs
# Warning: This may take a while for thousands of jobs
all_jobs = client.search_all_jobs()
4. Get Job Count for Different Queries
queries = ["engineer", "designer", "manager", "retail"]
for query in queries:
count = client.get_total_jobs(query=query)
print(f"{query}: {count} jobs")
β οΈ Important Notes
Rate Limiting: The API doesn't appear to have explicit rate limits in the HAR file, but be respectful and avoid hammering the server.
CSRF Token Lifespan: CSRF tokens appear to have a session-based lifespan. The client handles token refresh automatically.
Pagination: Results appear to return ~20 jobs per page. Use
totalRecordsto calculate total pages.Filters: The exact filter structure may vary. Common filters include:
postLocation: Location IDsteam: Team/department IDsrole: Role type IDs
Locale Support: The API supports multiple locales (en-us, fr-fr, etc.). Results are localized based on the locale parameter.
Job URLs: Job URLs follow the pattern:
https://jobs.apple.com/{locale}/details/{positionId}/{transformedPostingTitle}
π οΈ Testing
Run the example script to test the client:
python api_client.py
This will demonstrate:
- Fetching the first page of jobs
- Searching with queries
- Getting total job counts
- Pagination
π API Changes
This client was reverse-engineered from a HAR file captured on 2025-12-22. Apple may change their API at any time without notice. If the client stops working:
- Capture a new HAR file from the jobs.apple.com website
- Inspect the network requests for API changes
- Update the client accordingly
π€ Contributing
If you discover additional API endpoints or filter options, please document them here!
β‘ Quick Start Example
#!/usr/bin/env python3
from api_client import AppleJobsAPI
import json
# Initialize client
client = AppleJobsAPI(locale="en-us")
# Get first page of jobs
jobs = client.search_jobs(page=1)
# Extract requested fields: URL, Title, Location, Description
results = []
for job in jobs:
results.append({
"url": job.url,
"title": job.postingTitle,
"location": job.locations[0].name if job.locations else "N/A",
"description": job.jobSummary
})
# Print as JSON
print(json.dumps(results, indent=2, ensure_ascii=False))
Save this as quick_example.py and run it to get started immediately!