Skip to content

The agent that turns websites into APIs!

5.0 KB
Raw Blame

Quick Start Guide - Apple Jobs API Client

Get started in 3 simple steps to extract Apple job listings!

πŸš€ Quick Start

1. Install Dependencies

pip install requests
# or
pip install -r requirements.txt

2. Run the Extraction Script

Get all jobs (first 5 pages):

python extract_job_fields.py

Search for specific jobs:

python extract_job_fields.py --query "software engineer"
python extract_job_fields.py --query "designer"
python extract_job_fields.py --query "manager"

3. Find Your Results

The script automatically creates:

  • apple_jobs_[N]_jobs.json - JSON format
  • apple_jobs_[N]_jobs.csv - CSV format

πŸ“¦ What You Get

Each job includes exactly what was requested:

{
  "url": "https://jobs.apple.com/en-us/details/200125391/software-engineer",
  "title": "Software Engineer",
  "location": "United States",
  "description": "Full job description text here..."
}

πŸ’» Code Examples

Example 1: Basic Usage

from api_client import AppleJobsAPI

# Initialize
client = AppleJobsAPI(locale="en-us")

# Get jobs
jobs = client.search_jobs(page=1)

# Extract fields
for job in jobs:
    print(f"URL: {job.url}")
    print(f"Title: {job.postingTitle}")
    print(f"Location: {job.locations[0].name}")
    print(f"Description: {job.jobSummary}")

Example 2: Search with Query

from api_client import AppleJobsAPI

client = AppleJobsAPI()

# Search for engineering jobs
jobs = client.search_jobs(query="engineer")

print(f"Found {len(jobs)} engineering jobs")

Example 3: Get All Jobs

from api_client import AppleJobsAPI

client = AppleJobsAPI()

# Get all jobs (with pagination)
all_jobs = client.search_all_jobs(max_pages=10)

print(f"Retrieved {len(all_jobs)} total jobs")

Example 4: Export to JSON

from api_client import AppleJobsAPI
import json

client = AppleJobsAPI()
jobs = client.search_all_jobs(max_pages=5)

# Extract fields
data = []
for job in jobs:
    data.append({
        "url": job.url,
        "title": job.postingTitle,
        "location": job.locations[0].name if job.locations else "N/A",
        "description": job.jobSummary
    })

# Save to file
with open('jobs.json', 'w') as f:
    json.dump(data, f, indent=2)

Example 5: Export to CSV

from api_client import AppleJobsAPI
import csv

client = AppleJobsAPI()
jobs = client.search_all_jobs(max_pages=5)

with open('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
        })

🎯 Common Tasks

Get total job count

client = AppleJobsAPI()
total = client.get_total_jobs()
print(f"Total jobs: {total}")

Search by keyword

client = AppleJobsAPI()
jobs = client.search_jobs(query="software engineer")

Get multiple pages

client = AppleJobsAPI()
jobs = client.search_all_jobs(max_pages=10)

Change locale

client = AppleJobsAPI(locale="fr-fr")  # French
jobs = client.search_jobs(page=1)

πŸ“ Available Scripts

Script Purpose Usage
api_client.py Main API client library Import in your code
extract_job_fields.py Extract jobs to JSON/CSV python extract_job_fields.py
quick_example.py Interactive example python quick_example.py

βœ… Verified Output

The API client has been tested and successfully extracts:

βœ“ URL - Full job posting URL βœ“ Title - Job posting title βœ“ Location - Geographic location βœ“ Description - Complete job description

Example output:

Title: Software Engineer
Location: United States
URL: https://jobs.apple.com/en-us/details/200125391/software-engineer
Description: We are looking for a talented software engineer...

πŸ“Š Current Statistics

  • Total Jobs Available: ~6,179 (as of Dec 22, 2025)
  • Jobs Per Page: ~20
  • Supported Locales: en-us, fr-fr, and more
  • API Version: v1

πŸ› οΈ Troubleshooting

Issue: ModuleNotFoundError: No module named 'requests' Solution: Run pip install requests

Issue: No jobs returned Solution: Check your internet connection and try again

Issue: CSRF token error Solution: The client automatically handles this, but if it persists, restart your script


πŸ“š More Information

  • See README.md for full API documentation
  • See SUMMARY.md for technical details
  • See api_client.py for implementation details

πŸŽ‰ You're Ready!

Run this command to get started:

python extract_job_fields.py --query "engineer"

This will fetch engineering jobs and save them to JSON and CSV files with the exact fields you requested: URL, Title, Location, Description.

Happy job hunting! 🍎