Amazon Jobs API endpoint
Searches Amazon's public careers site (amazon.jobs). Each result includes the full description and qualifications inline. `sort` accepts `relevant` (default, relevance ranking) or `recent` (newest posted first). Either `q` or `category` (or both) must be given -- `category` filters by Amazon's own job-category taxonomy and works with no text query at all. See `amazon-jobs-categories` for the full, live-verified list of accepted `category` values.
/amazon-jobs/searchSearches Amazon's public careers site (amazon.jobs). Each result includes the full description and qualifications inline, so most callers won't need a follow-up call to the job detail endpoint.
Query parameters:
q: search query. Either q or category (or both) is required.category: Amazon's own job-category taxonomy slug — filters by Amazon's own classification rather than a text match, and works with no q at all. Either q or category is required. Matching is case-insensitive. Allowed values: administrative-support, applied-science, audio-video-photography-production, business-intelligence, business-merchant-development, buying-planning-instock-management, corporate-operations, customer-service, data-science, database-administration, design, economics, editorial-writing-content-management, facilities-maintenance-real-estate, finance-accounting, fulfillment-associate, fulfillment-operations-management, fulfillment-warehouse-associate, hardware-development, human-resources, investigation-loss-prevention, leadership-development-training, legal, machine-learning-science, marketing-pr, medical-health-safety, operations-it-support-engineering, procurement, project-program-product-management-non-tech, project-program-product-management-technical, public-policy, public-relations, research-science, sales-advertising-account-management, software-development, solutions-architect, supply-chain-transportation-management, systems-quality-security-engineering. Use amazon-jobs/categories to discover this list with live per-category job counts.country: optional ISO 3166-1 alpha-3 country code filter (e.g. USA, IND, GBR).page: optional page number, 1-based. Defaults to 1.limit: optional results per page, max 100. Defaults to 20.sort: optional enum. Allowed values: relevant (default, upstream relevance ranking), recent (newest posted first).Notable response behavior:
total: 0 and an empty jobs array (not an error). A category can also legitimately have zero open postings at a given moment — check amazon-jobs/categories's live count rather than assuming a total: 0 response means the category value itself is wrong.jobs[].description, basic_qualifications, and preferred_qualifications are HTML-stripped plain text.jobs[].posted_at is best-effort parsed to RFC3339 from Amazon's free-text posted date; it is omitted if the upstream format ever drifts.category, limit (over 100), or sort values return an invalid-parameter error before upstream IO.search.json did not honor it reliably during research; only the country filter was confirmed working.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| title | 20 | “Software Engineer” and 17 other values |
| company | 20 | “Amazon Web Services Australia Pty Ltd” and 12 other values |
| location | 20 | “Sydney, New South Wales, AUS” and 11 other values |
| city | 20 | “Sydney” and 11 other values |
| state | 17 | “NSW” and 9 other values |
| country | 20 | USA (10), IND (3), AUS (2) and 4 more |
| category | 20 | Software Development (19), Systems, Quality, & Security En… (1) |
| schedule_type | 20 | full-time in all 20 |
| posted_at | 20 | 2025-11-27 to 2026-10-12 |
| description | 20 | median 2,415 characters |
| basic_qualifications | 20 | median 489 characters |
| preferred_qualifications | 20 | median 1,559 characters |
| url | 20 | amazon.jobs |
| apply_url | 20 | account.amazon.com and 1 other host |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | No | Search query. Either q or category is required | software engineer | |
| category | string | No | Amazon's own job-category taxonomy slug, case-insensitive. Either q or category is required Allowed values: administrative-support, applied-science, audio-video-photography-production, business-intelligence, business-merchant-development, buying-planning-instock-management, corporate-operations, customer-service, data-science, database-administration, design, economics, editorial-writing-content-management, facilities-maintenance-real-estate, finance-accounting, fulfillment-associate, fulfillment-operations-management, fulfillment-warehouse-associate, hardware-development, human-resources, investigation-loss-prevention, leadership-development-training, legal, machine-learning-science, marketing-pr, medical-health-safety, operations-it-support-engineering, procurement, project-program-product-management-non-tech, project-program-product-management-technical, public-policy, public-relations, research-science, sales-advertising-account-management, software-development, solutions-architect, supply-chain-transportation-management, systems-quality-security-engineering. | software-development | |
| country | string | No | ISO 3166-1 alpha-3 country code filter | USA | |
| page | integer | No | Page number, 1-based | 1 | |
| limit | integer | No | Results per page, max 100 (default 20) | 20 | |
| sort | string | No | Sort order Allowed values: relevant, recent. | relevant | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/amazon-jobs/search?q=coffee&category=administrative-support&country=us&page=1&limit=10&sort=relevant" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "software engineer",
"country": "USA",
"page": 1,
"limit": 20,
"total": 2027,
"jobs": [
{
"id": "10386857",
"title": "Software Engineer",
"company": "Amazon Web Services Australia Pty Ltd",
"location": "Sydney, New South Wales, AUS",
"city": "Sydney",
"state": "NSW",
"country": "AUS",
"category": "Software Development",
"schedule_type": "full-time",
"posted_at": "2026-04-09T00:00:00Z",
"description": "AWS Infrastructure Services owns the design, planning, delivery, and operation of all AWS global infrastructure...",
"basic_qualifications": "Bachelor's degree in Computer Science or other technical degree or related experience...",
"preferred_qualifications": "Experience building complex software systems that have been successfully delivered to customers...",
"url": "https://www.amazon.jobs/en/jobs/10386857/software-engineer",
"apply_url": "https://account.amazon.com/jobs/10386857/apply"
}
],
"source_url": "https://www.amazon.jobs/en/search.json?base_query=software+engineer&limit=20&offset=0&result_limit=20"
}
}Request schema
No body schema
Response schema
#/definitions/amazonjobs.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | amazonjobs.SearchResponse | No | ||||
| data.category | string | No | software-development | |||
| data.country | string | No | USA | |||
| data.jobs | array | No | AmazonJob record, 15 fields: apply_url, basic_qualifications, category, city, company, country, description, id, location, posted_at, preferred_qualifications, schedule_type and 3 more. Described under Amazon Jobs single posting API. | |||
| data.limit | integer | No | 20 | |||
| data.page | integer | No | 1 | |||
| data.query | string | No | software engineer | |||
| data.source_url | string | No | ||||
| data.total | integer | No | 2027 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/amazon-jobs/search?q=coffee&category=administrative-support&country=us&page=1&limit=10&sort=relevant" \
-H "x-api-key: $CRAWLORA_API_KEY"