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_KEYin the environment before running the helper. - The helper reads
CRAWLORA_API_KEYfrom the environment and sends requests tohttps://api.crawlora.net/api/v1. Missing/invalid key →401.
How it works
- Search —
/amazon-jobs/searchqueries amazon.jobs's credential-free search JSON. Eitherq(text query) orcategory(Amazon's own job-category taxonomy slug) is required — pass both to narrow further. Optionalcountry(ISO 3166-1 alpha-3) filters by location,sortpicksrelevant(default) orrecent, andlimit/pagepaginate results. Each result already includes the full description and qualifications inline, so a detail call is only needed to re-fetch one posting later. - Job detail —
/amazon-jobs/jobreturns one posting by its numeric Amazon jobid(theidfield 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-recruitingwith no text query to list every open role in a category, then page through withpage/limit. - Track one posting over time: save the
idfrom 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_KEYonly — never hardcode, query-param, or commit it. - Either
qorcategoryis 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.