Sam's Club API endpoint
Returns the related-item carousels shown on a Sam's Club product page, each a named shelf (e.g. "Members also considered", "Items you may like") of products with pricing, rating, and image. id is the numeric product id from a Sam's Club product page's /ip/ URL. An unrecognized id is not distinguished from a known one -- it still returns generic fallback shelves rather than an error.
/samsclub/product/{id}/relatedNotable response behavior:
shelves lists every related-item carousel the page shows that has at least one item, in the order the page itself renders them. Each shelf's title is the label shown above it.id still returns generic fallback shelves rather than an error or an empty result.400 before any upstream request is made.| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| title | 2 | “Members also considered” and 1 other value |
| items | 2 | median 15 entries |
| 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/related" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"item_id": "13610014888",
"shelves": [
{
"title": "Members also considered",
"items": [
{
"item_id": "13576901230",
"name": "Tide PODS Laundry Detergent Pacs, Spring Meadow, 156 ct.",
"currency_code": "USD",
"price": 29.98,
"rating": 4.8184,
"review_count": 13701,
"availability": "IN_STOCK",
"image_url": "https://i5.samsclubimages.com/asr/633d38ab-3838-4098-932e-b2f15af4f2b4.bbbf3ccda9959424955e9fc72791b3b3.jpeg",
"url": "https://www.samsclub.com/ip/Tide-PODS-Laundry-Detergent-Pacs-Spring-Meadow-156-ct/13576901230"
}
]
},
{
"title": "Items you may like",
"items": [
{
"item_id": "6AM78BEVW2IS",
"name": "Tide Hygienic Clean Power PODS Laundry Detergent Pacs, Original, 72 ct.",
"currency_code": "USD",
"price": 19.98,
"rating": 4.62,
"review_count": 223,
"availability": "IN_STOCK",
"image_url": "https://i5.samsclubimages.com/asr/example.jpeg",
"url": "https://www.samsclub.com/ip/Tide-Hygienic-Clean-Power-PODS/6AM78BEVW2IS"
}
]
}
],
"source_url": "https://www.samsclub.com/orchestra/pdp/graphql/ItemByIdBtf/.../ip/13610014888",
"fetched_at": "2026-08-11T04:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/samsclub.relatedItemsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | samsclub.RelatedItemsResponse | No | ||||
| data.fetched_at | string | No | ||||
| data.item_id | string | No | 13610014888 | |||
| data.shelves | array | No | RelatedShelf record, 11 fields: items, title. Described under Sam's Club Content Page API. | |||
| data.source_url | string | No | ||||
| 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/product/13610014888/related" \
-H "x-api-key: $CRAWLORA_API_KEY"