Sam's Club API endpoint
Returns a Sam's Club category or collection page's product grid, with real page-based pagination. id accepts a bare numeric category id (from a nav link's /browse/{id} URL) or a full /browse/{slug}/{id} URL copied from samsclub.com -- only the trailing id is used. Returns products with name, brand, pricing, availability, rating, and image. An id samsclub.com does not recognize returns a genuine zero-result response rather than an error.
/samsclub/categoryid is required. It accepts a bare numeric category id (from a nav link's /browse/{id} URL) or a full /browse/{slug}/{id} URL copied from samsclub.com -- only the trailing id is used. page is optional, 1-based, defaults to 1.
Notable response behavior:
max_page is the site's own last page; total_count is the category's total result count across all pages.current_price is what a guest shopper actually pays; regular_price equals current_price when the item is not on sale, and is higher (with on_sale: true and a nonzero savings_amount) when it is.unit_price_text is the per-unit price display (e.g. $0.28/ea) when the upstream provides it.breadcrumb is the category's own breadcrumb trail, ordered from the top-level department down to the requested category.id Sam's Club does not recognize returns a genuine zero-result response (count: 0, empty products) rather than an error -- Sam's Club does not distinguish an unrecognized id from a legitimately empty category on this page.| Field | Filled in, of 45 checked | Values in the sample |
|---|---|---|
| item_id | 45 | |
| name | 45 | “Member's Mark 11-Piece Modern Ceramic Cookware Set” and 44 other values |
| type | 45 | “Cookware Sets” and 27 other values |
| currency_code | 45 | |
| current_price | 45 | 8.88 to 4,299, median 29.96 |
| regular_price | 45 | 8.88 to 4,299, median 29.96 |
| on_sale | 45 | true in 3 of 45 |
| savings_amount | 3 | 10 to 1,200, median 50 |
| availability | 45 | IN_STOCK (44), OUT_OF_STOCK (1) |
| rating | 44 | 1 to 4.89, median 4.65 |
| review_count | 44 | 1 to 8,154, median 684 |
| image_url | 45 | i5.samsclubimages.com |
| url | 45 | samsclub.com |
| unit_price_text | 31 | “$0.14/ea” and 26 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | Yes | Sam's Club category id, or a /browse/{slug}/{id} URL | 15660127 | |
| page | integer | No | 1 | Result page, 1-based, defaults to 1 | 1 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/samsclub/category?id=15660127&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"category_id": "15660127",
"title": "Results for \"Savings\"",
"breadcrumb": [
{
"id": "100001",
"name": "All Departments",
"url": "https://www.samsclub.com/all-departments"
},
{
"id": "5170105",
"name": "Savings",
"url": "https://www.samsclub.com/browse/Savings/5170105"
}
],
"page": 1,
"max_page": 16,
"count": 2,
"total_count": 687,
"has_more": true,
"products": [
{
"item_id": "13610014888",
"name": "Tide Power PODS + Ultra OXI Laundry Detergent Pacs, 72 ct.",
"type": "Laundry Detergents",
"currency_code": "USD",
"current_price": 19.98,
"regular_price": 24.98,
"on_sale": true,
"savings_amount": 5,
"unit_price_text": "$0.28/ea",
"availability": "IN_STOCK",
"rating": 4.8156,
"review_count": 4122,
"image_url": "https://i5.samsclubimages.com/asr/638eb209-14c5-4a77-8222-cd5c31bd6852.c96234e029bf7888112ad2b74501dee8.jpeg",
"url": "https://www.samsclub.com/ip/Tide-Power-PODS-Ultra-OXI-Laundry-Detergent-Pacs-72-ct/13610014888"
}
],
"source_url": "https://www.samsclub.com/browse/15660127",
"fetched_at": "2026-08-11T04:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/samsclub.categoryResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | samsclub.CategoryResponse | No | ||||
| data.breadcrumb | array | No | ||||
| data.breadcrumb[].id | string | No | 100001 | |||
| data.breadcrumb[].name | string | No | All Departments | |||
| data.breadcrumb[].url | string | No | https://www.samsclub.com/all-departments | |||
| data.category_id | string | No | 15660127 | |||
| data.count | integer | No | 47 | |||
| data.fetched_at | string | No | ||||
| data.has_more | boolean | No | true | |||
| data.max_page | integer | No | 16 | |||
| data.page | integer | No | 1 | |||
| data.products | array | No | ||||
| data.products[].availability | string | No | IN_STOCK | |||
| data.products[].brand | string | No | Tide | |||
| data.products[].currency_code | string | No | USD | |||
| data.products[].current_price | number | No | 19.98 | |||
| data.products[].image_url | string | No | ||||
| data.products[].item_id | string | No | 13610014888 | |||
| data.products[].name | string | No | Tide Power PODS + Ultra OXI Laundry Detergent Pacs, 72 ct. | |||
| data.products[].on_sale | boolean | No | true | |||
| data.products[].rating | number | No | 4.8 | |||
| data.products[].regular_price | number | No | 24.98 | |||
| data.products[].review_count | integer | No | 4122 | |||
| data.products[].savings_amount | number | No | 5 | |||
| data.products[].type | string | No | Laundry Detergents | |||
| data.products[].unit_price_text | string | No | $0.28/ea | |||
| data.products[].url | string | No | https://www.samsclub.com/ip/Tide-Power-PODS-Ultra-OXI-Laundry-Detergent-Pacs-72-ct/13610014888 | |||
| data.source_url | string | No | ||||
| data.title | string | No | Results for "Savings" | |||
| data.total_count | integer | No | 687 | |||
| 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/samsclub/category?id=15660127&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"