Sam's Club API endpoint
Returns one Sam's Club product's full detail: name, brand, description, category breadcrumb, pricing, availability, images, aggregate rating and review count, and the club's own item number. id is the numeric product id from a Sam's Club product page's /ip/ URL.
/samsclub/product/{id}id is required and is the numeric product id from a Sam's Club product page's /ip/{slug}/{id} URL (e.g. 13610014888 from https://www.samsclub.com/ip/tide-power-pods-ultra-oxi-odor-eliminator-laundry-detergent-pacs/13610014888).
Notable response behavior:
item_number is Sam's Club's own club/warehouse item number, distinct from id (the catalog product id used in the URL).regular_price and current_price are both the same value when the product is not on sale, and diverge when on_sale is true (current_price is what a shopper actually pays).unit_price/unit_price_text is the per-unit price display (e.g. $0.28/ea) when the upstream provides it.category is the product's breadcrumb path, ordered from the top-level department down to the most specific category.images is the product's full image gallery as absolute URLs.rating and review_count are the product's aggregate review statistics; both are 0 when the product has no reviews yet.id returns 404. An id containing invalid characters returns 400 before any upstream request is made.| Field | In the sample | Value in the sample |
|---|---|---|
| item_id | Has a value | |
| item_number | Has a value | 990,471,947 |
| name | Has a value | “Tide Power PODS + Ultra OXI Laundry Detergent Pacs, 72 ct.” |
| brand | Has a value | “Tide” |
| description | Has a value | 1,778 characters |
| highlights | Has a value | 2 entries |
| category | Has a value | 4 entries |
| upc | Has a value | |
| currency_code | Has a value | |
| regular_price | Has a value | 25.48 |
| current_price | Has a value | 25.48 |
| on_sale | Has a value | false |
| unit_price | Has a value | 0.35 |
| unit_price_text | Has a value | “$0.35/ea” |
| availability | Has a value | “IN_STOCK” |
| images | Has a value | 10 entries |
| rating | Has a value | 4.81 |
| review_count | Has a value | 4,434 |
| url | Has a value | samsclub.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Numeric Sam's Club product id, from a product page's /ip/{slug}/{id} URL | 13610014888 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/samsclub/product/13610014888" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"item_id": "13610014888",
"item_number": "990471947",
"name": "Tide Power PODS + Ultra OXI Laundry Detergent Pacs, 72 ct.",
"brand": "Tide",
"description": "<p>There are two things that let you know your clothes are clean...</p>",
"highlights": [
"Brand: Tide",
"Product Net Content UOM: Each"
],
"category": [
"All Departments",
"Household Essentials",
"Laundry Supplies",
"Laundry Detergent"
],
"upc": "030772073438",
"currency_code": "USD",
"regular_price": 24.98,
"current_price": 19.98,
"on_sale": true,
"unit_price": 0.28,
"unit_price_text": "$0.28/ea",
"savings_amount": 5,
"availability": "IN_STOCK",
"images": [
"https://i5.samsclubimages.com/asr/638eb209-14c5-4a77-8222-cd5c31bd6852.c96234e029bf7888112ad2b74501dee8.jpeg"
],
"rating": 4.8156,
"review_count": 4122,
"url": "https://www.samsclub.com/ip/13610014888"
}
}Request schema
No body schema
Response schema
#/definitions/samsclub.productResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | samsclub.Product | No | ||||
| data.availability | string | No | IN_STOCK | |||
| data.brand | string | No | Tide | |||
| data.category | array | No | All Departments,Household Essentials,Laundry Supplies,Laundry Detergent | |||
| data.currency_code | string | No | USD | |||
| data.current_price | number | No | 19.98 | |||
| data.description | string | No | ||||
| data.highlights | array | No | ||||
| data.images | array | No | ||||
| data.item_id | string | No | 13610014888 | |||
| data.item_number | string | No | 990471947 | |||
| data.name | string | No | Tide Power PODS + Ultra OXI Laundry Detergent Pacs, 72 ct. | |||
| data.on_sale | boolean | No | true | |||
| data.rating | number | No | 4.8 | |||
| data.regular_price | number | No | 24.98 | |||
| data.review_count | integer | No | 4122 | |||
| data.savings_amount | number | No | 5 | |||
| data.unit_price | number | No | 0.28 | |||
| data.unit_price_text | string | No | $0.28/ea | |||
| data.upc | string | No | 030772073438 | |||
| data.url | string | No | https://www.samsclub.com/ip/13610014888 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/product/13610014888" \
-H "x-api-key: $CRAWLORA_API_KEY"