Warehouse-club price monitoring
Use Sam's Club endpoints to turn warehouse-club price monitoring into repeatable API requests with documented inputs and JSON responses.
Turn Sam's Club into structured warehouse-club data — the full department and category taxonomy, paginated category product grids, curated landing pages, related-item carousels, and full product detail with sale-aware pricing, availability, images, ratings and the club's own item number. All normalized JSON, credential-free. There is no free-text search endpoint: Sam's Club's own robots.txt disallows crawling its search results.
Browse Sam's Club categories with real pagination, walk the department taxonomy, and get full product detail as structured JSON.
Endpoint families
4
Documented params
10
Examples
5
Live catalog snapshot
Active endpoints
5
Methods
GET
Required params
9
Schema refs
5
{
"platform": "Sam's Club",
"endpoint": "samsclub-category",
"method": "GET",
"path": "/samsclub/category",
"auth": "apiKey"
}Use cases
Browse Sam's Club categories with real pagination, walk the department taxonomy, and get full product detail as structured JSON.
Use Sam's Club endpoints to turn warehouse-club price monitoring into repeatable API requests with documented inputs and JSON responses.
Use Sam's Club endpoints to turn category and assortment tracking into repeatable API requests with documented inputs and JSON responses.
Use Sam's Club endpoints to turn product catalog enrichment into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Sam's Club endpoint catalog — 5 endpoints, 10 documented request parameters, and 5 published response schemas — the same catalog Docs and Playground run against.
5 documented Sam's Club endpoints, grouped into 4 request families — Product, Category and Content, plus 1 more.
10 request parameters are documented across those Sam's Club endpoints, 9 of them required — the full input contract is public before you write any integration code.
5 of the 5 Sam's Club endpoints ship a recorded example response, and 5 carry a documented response schema — you can code against the real JSON before the first request.
Sam's Club endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
5 hosted MCP tools back the Sam's Club endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/samsclub/product/{id}
/samsclub/category
/samsclub/content/{id}
/samsclub/departments
Endpoint catalog
/samsclub/categoryReturns 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 normalized 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, matching upstream's own behavior.
Response notes
- Pagination is real and page-based. `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. - An `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. Example response: ```json {"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"}} ```
MCP tool samsclub_category
/samsclub/product/{id}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.
Response notes
- `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. - Pricing, rating, and review data reflect what is visible to a guest (unauthenticated, non-member) shopper; no membership sign-in is required or used. - `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. - An unrecognized `id` returns `404`. An id containing invalid characters returns `400` before any upstream request is made. Example response: ```json {"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"}} ```
MCP tool samsclub_product
/samsclub/departmentsReturns 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).
Response notes
- Each department and subcategory link carries a `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. Example response: ```json {"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"}} ```
MCP tool samsclub_departments
/samsclub/product/{id}/relatedReturns 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 normalized products with pricing, rating, and image. id is the numeric product id from a Sam's Club product page's /ip/ URL. This upstream source does not distinguish an unrecognized id from a known one -- an unrecognized id still returns generic fallback shelves rather than an error.
Response notes
- `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. - This upstream source does not distinguish an unrecognized product id from a known one -- an unrecognized `id` still returns generic fallback shelves rather than an error or an empty result. - An id containing invalid characters returns `400` before any upstream request is made. Example response: ```json {"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"}} ```
MCP tool samsclub_product_related
/samsclub/content/{id}Returns one Sam's Club curated content/landing page (e.g. a seasonal savings hub or a "New Arrivals" page) -- distinct data from GET /samsclub/category's flat, paginated product grid. id accepts a bare numeric content page id (from a nav link's /cp/{id} URL) or a full /cp/{slug}/{id} URL copied from samsclub.com -- only the trailing id is used. Returns a title, breadcrumb, named curated product shelves, and a category-navigation tile grid. There is no pagination -- a content page's shelves are a fixed, hand-curated set. An id samsclub.com does not recognize returns a 404, unlike GET /samsclub/category's zero-result response for the same situation.
Response notes
- `shelves` lists every curated product 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 -- the same shape `GET /samsclub/product/{id}/related` returns. - `category_links` lists the page's own category-navigation tiles (e.g. "Grocery & Household", "Health & Beauty"), the same link shape `GET /samsclub/departments` returns. - There is no pagination. A content page's shelves are a fixed, hand-curated set -- unlike `GET /samsclub/category`'s real page-based pagination. - An `id` samsclub.com does not recognize returns `404`, unlike `GET /samsclub/category`'s zero-result response for the same situation -- samsclub.com's own response for this call distinguishes the two cases. Example response: ```json {"code":200,"msg":"OK","data":{"id":"16050279","title":"Savings Center","breadcrumb":[{"id":"100001","name":"All Departments","url":"https://www.samsclub.com/all-departments"},{"id":"7130108","name":"Shops & Promotions","url":"https://www.samsclub.com/cp/shops-promotions/7130108"},{"id":"5170105","name":"Savings","url":"https://www.samsclub.com/cp/shop-savings/5170105"},{"id":"16050279","name":"Savings & Clearance","url":"https://www.samsclub.com/cp/savings-center/16050279"}],"shelves":[{"title":"Clearance","items":[{"item_id":"17389419489","name":"Member's Mark Boys Favorite Jacket","currency_code":"USD","price":11.81,"rating":4.8571,"review_count":28,"availability":"IN_STOCK","image_url":"https://i5.samsclubimages.com/asr/example.jpeg","url":"https://www.samsclub.com/ip/Member-s-Mark-Boys-Favorite-Jacket/17389419489"}]}],"category_links":[{"name":"Grocery & Household","type":"browse","id":"4750103","url":"https://www.samsclub.com/browse/grocery-household-savings/4750103"}],"source_url":"https://www.samsclub.com/cp/16050279","fetched_at":"2026-08-11T06:00:00Z"}} ```
MCP tool samsclub_content
Related APIs
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
Company coverage
Walmart Inc. · WMT
Sam's Club is operated by Walmart Inc. (WMT). Crawlora's SEC endpoints take the same company's CIK, so filings, financials, insider transactions and 13F holdings come from the same API key as the Sam's Club endpoints above.
Other Walmart Inc. platforms in the catalog
How to scrape Sam's Club
Crawlora covers Sam's Club in five endpoints — the department taxonomy, paginated category grids, curated landing pages, product detail and related-item shelves — all normalized JSON behind one API key, with no Sam's Club account. Discovery starts from the taxonomy rather than from a search box, because Sam's Club does not permit search crawling.
/samsclub/departments returns every top-level department with its subcategory list — 24 departments at the time of writing. Each link carries a type: browse ids pair directly with the category endpoint, while cp ids point at a curated content page that does not reliably carry a product grid. Check the type before you use an id.
Pass a browse id to /samsclub/category for that grid. Pagination is real and page-based: the response reports page, count, max_page, total_count and has_more, so a category like Office Supplies comes back as 45 items on page 1 of 2 with 53 in total. The id parameter also accepts a full /browse/{slug}/{id} URL pasted from the site — only the trailing id is used.
current_price is what a guest shopper actually pays. regular_price equals it off-sale and sits higher when on_sale is true, alongside a nonzero savings_amount, and unit_price_text carries the per-unit display such as $0.28/ea.
Take the numeric id from a product's /ip/{slug}/{id} URL and call /samsclub/product/{id} for brand, description, category breadcrumb, pricing, availability, images, aggregate rating with review count, and item_number — the club's own warehouse item number, which is a different identifier from the catalog id in the URL.
/samsclub/product/{id}/related returns the carousels the product page shows, each a named shelf such as Members also considered. Note that this upstream does not distinguish an unknown product id from a real one — an unrecognised id still returns generic fallback shelves rather than an error.
FAQ
Not by free text — Sam's Club's own robots.txt disallows crawling its search results, so no /samsclub/search endpoint is offered. You browse instead: /samsclub/departments gives the full taxonomy and /samsclub/category returns any browse category's product grid with real page-based pagination, which covers most of what a search would have been used for.
Yes, genuinely — not a first-page-only stub. Each response reports page, count, max_page, total_count and has_more, so you can walk a category to the end. Verified live: the Office Supplies category returns 45 products on page 1 of 2 with a total of 53.
Take the numeric id from the product's own /ip/{slug}/{id} URL and pass it to /samsclub/product/{id}. Note that the item_number in the response is a different identifier — Sam's Club's warehouse item number — so don't feed it back in as the id.
Sam's Club blocks some automated requests at the edge, and Crawlora surfaces that honestly as a 503 saying the request was blocked upstream rather than returning an empty result that looks like a real answer. It is intermittent and per-id — retry, and remember blocks cost you no credits since Crawlora bills only successful 2xx responses.
/samsclub/product/{id} returns the aggregate rating and review count — individual review text is not available from this endpoint.