Sam's Club API endpoint
Returns Sam's Club's full department/category taxonomy, as shown on its own "All Departments" page: every top-level department with its own subcategory list. Each link's type is "browse" (pairs directly with GET /samsclub/category), "cp" (a content/landing page that does not reliably carry a product grid), or empty (an unrecognized link shape).
/samsclub/departmentsThis endpoint takes no parameters.
Notable response behavior:
type, one of: browse, cp, or an empty string (an unrecognized link shape). browse ids pair directly with GET /samsclub/category. cp ids point at a content/landing page that does not reliably carry a product grid -- do not assume a cp id works with /samsclub/category.url is absolute and has tracking query parameters (e.g. a mid= marketing-campaign id) stripped.image_url is only present on top-level departments, not subcategories.| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| name | 24 | “Savings” and 23 other values |
| type | 24 | cp (23), browse (1) |
| id | 23 | |
| url | 24 | samsclub.com |
| image_url | 24 | i5.samsclubimages.com |
| subcategories | 24 | median 12 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/samsclub/departments" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"departments": [
{
"name": "Savings",
"type": "cp",
"id": "5170105",
"url": "https://www.samsclub.com/cp/5170105",
"image_url": "https://i5.samsclubimages.com/dfw/5a870ffe-ae52/k2-_3cc2f464-40fa-4946-9e2d-6e89f2d711b9.v1.jpg",
"subcategories": [
{
"name": "Savings & Clearance",
"type": "cp",
"id": "16050279",
"url": "https://www.samsclub.com/cp/16050279"
},
{
"name": "All Savings",
"type": "browse",
"id": "16050279",
"url": "https://www.samsclub.com/browse/16050279"
}
]
},
{
"name": "Grocery",
"type": "browse",
"id": "1444",
"url": "https://www.samsclub.com/browse/1444",
"image_url": "https://i5.samsclubimages.com/dfw/5a870ffe-17b0/k2-_53bebd5b-f106-4523-8a2d-da172fb03d17.v1.jpg",
"subcategories": [
{
"name": "All Grocery",
"type": "cp",
"id": "1444",
"url": "https://www.samsclub.com/cp/1444"
},
{
"name": "Fresh Food",
"type": "cp",
"id": "430221",
"url": "https://www.samsclub.com/cp/430221"
}
]
}
],
"source_url": "https://www.samsclub.com/orchestra/home/graphql/AllDepartmentsPage/...",
"fetched_at": "2026-08-11T05:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/samsclub.departmentsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | samsclub.DepartmentsResponse | No | ||||
| data.departments | array | No | ||||
| data.departments[].id | string | No | 1444 | |||
| data.departments[].image_url | string | No | ||||
| data.departments[].name | string | No | Grocery | |||
| data.departments[].subcategories | array | No | DepartmentLink record, 4 fields: id, name, type, url. Described under Sam's Club Content Page API. | |||
| data.departments[].type | string | No | browse | |||
| data.departments[].url | string | No | https://www.samsclub.com/browse/1444 | |||
| data.fetched_at | string | No | ||||
| data.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 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/samsclub/departments" \
-H "x-api-key: $CRAWLORA_API_KEY"