Amazon Jobs search

Search Amazon's public careers site (amazon.jobs) and pull individual job postings as normalized JSON from the Crawlora API, no scraping amazon.jobs by hand.

When to use this skill

• "Search Amazon for jobs in ." — keyword/category search on amazon.jobs.
• "What is Amazon hiring for in ?" — filter by Amazon's own job-category taxonomy.
• "Show me the full listing for Amazon job id ." — pull one posting's description and qualifications.
• "What are the newest Amazon job postings for ?" — sort by most recently posted.

Setup (one-time)

• Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
• Set CRAWLORA_API_KEY in the environment before running the helper.
• The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

1. Search — /amazon-jobs/search queries amazon.jobs's credential-free search JSON. Either q (text query) or category (Amazon's own job-category taxonomy slug) is required — pass both to narrow further. Optional country (ISO 3166-1 alpha-3) filters by location, sort picks relevant (default) or recent, and limit/page paginate results. Each result already includes the full description and qualifications inline, so a detail call is only needed to re-fetch one posting later.
2. Job detail — /amazon-jobs/job returns one posting by its numeric Amazon job id (the id field from a search result). Parsed from amazon.jobs's stable server-rendered job page — there is no separate JSON detail endpoint upstream.

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

# Search by keyword + country, newest first:
scripts/crawlora.sh /amazon-jobs/search q="software development engineer" country=USA sort=recent | jq '.'

# Fetch one posting by id:
scripts/crawlora.sh /amazon-jobs/job id=2612345 | jq '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See reference/endpoints.md for both Amazon Jobs endpoints this skill uses.

Examples

• Category browse: /amazon-jobs/search category=hr-and-recruiting with no text query to list every open role in a category, then page through with page/limit.
• Track one posting over time: save the id from a search hit, then poll /amazon-jobs/job id=<id> on a schedule to detect edits or removal (a missing/changed result signals the role closed or was updated).

Notes & limits

• Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
• Public data only — public Amazon.jobs postings; respect Amazon's terms.
• Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
• Either q or category is required on /amazon-jobs/search — a call with neither will fail.
• Results are paginated — pass page/limit (max 100 per page) to walk the full list.