Warehouse-club price monitoring
Usa los endpoints de Sam's Club para convertir warehouse-club price monitoring en solicitudes API repetibles con inputs documentados y respuestas JSON.
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.
Familias de endpoints
4
Parámetros documentados
10
Ejemplos
5
Snapshot en vivo del catálogo
Endpoints activos
5
Métodos
GET
Parámetros obligatorios
9
Referencias de esquema
5
{
"platform": "Sam's Club",
"endpoint": "samsclub-category",
"method": "GET",
"path": "/samsclub/category",
"auth": "apiKey"
}Casos de uso
Browse Sam's Club categories with real pagination, walk the department taxonomy, and get full product detail as structured JSON.
Usa los endpoints de Sam's Club para convertir warehouse-club price monitoring en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Sam's Club para convertir category and assortment tracking en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Sam's Club para convertir product catalog enrichment en solicitudes API repetibles con inputs documentados y respuestas JSON.
Ejecución gestionada
Cada cifra de abajo se lee directamente del catálogo de endpoints en vivo de Sam's Club — 5 endpoints, 10 parámetros de solicitud documentados y 5 esquemas de respuesta publicados — el mismo catálogo contra el que corren Docs y Playground.
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.
Mapa de cobertura
/samsclub/product/{id}
/samsclub/category
/samsclub/content/{id}
/samsclub/departments
Catálogo de endpoints
/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 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.
Notas de la respuesta
- 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.
Herramienta MCP 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.
Notas de la respuesta
- `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.
Herramienta MCP 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).
Notas de la respuesta
- 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.
Herramienta MCP 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 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.
Notas de la respuesta
- `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.
Herramienta MCP 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.
Notas de la respuesta
- `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.
Herramienta MCP samsclub_content
APIs relacionadas
Marketplaces & Retail
Research new, used, and vintage instruments across Reverb listings, seller shops, and the Price Guide. Keep current asking prices separate from historical sales, and preserve model, finish, year, condition, and currency when comparing gear.
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.
Cobertura de la empresa
Walmart Inc. · WMT
Sam's Club es operado por Walmart Inc. (WMT). Los endpoints SEC de Crawlora usan el mismo CIK de esa empresa, así que los filings, datos financieros, transacciones de insiders y participaciones 13F provienen de la misma API key que los endpoints de Sam's Club de arriba.
Otras plataformas de Walmart Inc. en el catálogo
Cómo hacer scraping de 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.
Preguntas frecuentes
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.