Sam's Club API & Scraper
Sam's Club prices are set per club: on 2026-10-18 the same Samsung 50-inch TV cost $199.91 at the Dallas Timber Creek Crossing club and $297.99 at the Sioux Falls club, in the same minute.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API answers with the club named on every response. `search` returns the products for a search term with the card price, was-price and Instant Savings amount, unit price, stock status, pickup/delivery/shipping flags, rating, review count and SNAP flag, for Sam's Club's default club; the paid tiles Sam's Club mixes into its results come back apart in a sponsored list. `product` returns one item for the club you choose (club_id): the headline price plus the in-club, delivery and shipping price separately, the in-club stock count and aisle location, item number, UPC, brand, model, the full specification table, description, images, rating breakdown and the latest reviews. `clubs` lists the clubs near a US ZIP code with address, distance, services and hours, and `club_availability` tells you which of those clubs have one item in stock.
What a Sam's Club field actually contains
Fields that read differently from how they look. Every row was measured against live responses on 2026-10-18.
| Field | What it holds |
|---|---|
| club, store_defaulted | The club the prices and stock belong to. Samsung 50" M70H: $199.91 at club 6372 (Dallas, TX), $297.99 at club 8165 (Sioux Falls, SD). 7 of 107 products compared across clubs had a different price. store_defaulted is true when you did not pass club_id; search always answers for Sam's Club's default club. |
| price, price_display | The price the page leads with. It is the in-club price when that club sells the item and the shipping price when it does not: an LG OLED TV showed $1,349.91 (shipping) while its in-club price was $599.91 but not stocked at that club. |
| channel_prices | product only: the PICKUP (in-club), DELIVERY and SHIPPING price of the item side by side, each with its own was-price and unit price. |
| was_price, savings_amount, savings_text, price_type | Instant Savings: "Now $1,349.91", "SAVE $150.08", was $1,499.99. price_type MEMBER marks a member Instant Savings price. |
| unit_price | The comparison price on the label, for example $0.08/foz or $0.02/sft. |
| fulfillment_options[].available_quantity, aisle_location | product only: how many units the chosen club shows for pickup and where the item sits in that club (A8, A14, H3). |
| sponsored (list), total | Sam's Club mixes paid tiles into its results: 5 of the 45 cards on a "chicken" page, the same ones on every page, not narrowed by min_price/max_price. They come back in a separate sponsored list and never count in products or total. total is exact when all results fit on one page and otherwise an estimate (total_is_exact false), with Sam's Club's own count, ads included, in total_reported_by_site. |
| review_count, rating | The item page's own review total and average; search cards carry a card-level count that can trail the item page by a few reviews. |
Search is semantic: a word the site does not know still returns a few loosely related items ("zzqqxxyyqqvv" returned 8), and a few terms such as "tires" open a Sam's Club landing page instead of results, which this API reports as not found.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/samsclub/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "paper towels"
}
}{
"ok": true,
"meta": {
"api": "samsclub",
"endpoint": "search",
"mode": "live",
"latency_ms": 1706.9,
"record_count": 14,
"bytes": 497720,
"cache_hit": false,
"sponsored_rows": 5,
"source_url": "https://www.samsclub.com/s/paper%20towels",
"upstream_requests": 1,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "06c3518a5a984cd1",
"fetched_at": "2026-10-18T17:45:05.395Z"
},
"data": {
"products": [
{
"item_id": "18040450426",
"product_id": "6RL499HYDDC8",
"name": "Bounty Select-A-Size 2-Ply Paper Towels, 12 Rolls, 110 sheets/roll",
"url": "https://www.samsclub.com/ip/Bounty-Select-A-Size-2-Ply-Paper-Towels-12-Rolls-110-sheets-roll/18040450426",
"image": "https://i5.samsclubimages.com/asr/aa36b3a5-07a1-4373-be53-7f1fa68304bf.c09d0fd65a4e3bfab685afc2971c0f06.jpeg",
"price": 25.68,
"price_display": "$25.68",
"was_price": null,
"savings_amount": null,
"savings_text": null,
"price_type": null,
"unit_price": "$0.04/sft",
"price_range": null,
"currency": "USD",
"availability": "IN_STOCK",
"availability_text": "In stock",
"fulfillment": [
"PICKUP",
"DELIVERY",
"SHIPPING"
],
"pickup_club_id": "6372",
"rating": 4.8,
"review_count": 2916,
"department": null,
"product_type": "Paper Towels",
"category_path_id": "100001:450203:1340129:1110179",
"snap_eligible": false,
"badges": [
"Shipping",
"Pickup",
"Delivery as soon as 1 hour"
],
"promotions": [
"Sam's Cash Offer"
],
"sponsored": false,
"grid_position": 3,
"rank": 1
},
{
"item_id": "15390012477",
"product_id": "37YEP9R6BHPD",
"name": "Member's Mark Select & Tear 2-Ply Paper Towel 15 rolls, 150 sheets/roll",
"url": "https://www.samsclub.com/ip/Member-s-Mark-Select-Tear-2-Ply-Paper-Towel-15-rolls-150-sheets-roll/15390012477",
"image": "https://i5.samsclubimages.com/asr/69a12bfd-0ced-40d5-912f-4db82339029d.3174eeb11e6eaab1aa5923377b9ff7f8.jpeg",
"price": 20.93,
"price_display": "$20.93",
"was_price": null,
"savings_amount": null,
"savings_text": null,
"price_type": null,
"unit_price": "$0.02/sft",
"price_range": null,
"currency": "USD",
"availability": "IN_STOCK",
"availability_text": "In stock",
"fulfillment": [
"PICKUP",
"DELIVERY",
"SHIPPING"
],
"pickup_club_id": "6372",
"rating": 4.86,
"review_count": 155125,
"department": null,
"product_type": "Paper Towels",
"category_path_id": "100001:450203:1340129:1110179",
"snap_eligible": false,
"badges": [
"Shipping",
"Pickup",
"Delivery as soon as 1 hour"
],
"promotions": [],
"sponsored": false,
"grid_position": 4,
"rank": 2
},
{
"item_id": "19396800826",
"product_id": "779GKGNP6HLZ",
"name": "Member's Mark, Huge Roll 2 ply, White, Paper Towel 15 Rolls, 101 sheets/roll",
"url": "https://www.samsclub.com/ip/Member-s-Mark-Huge-Roll-2-ply-White-Paper-Towel-15-Rolls-101-sheets-roll/19396800826",
"image": "https://i5.samsclubimages.com/asr/0fee6af8-4183-484f-b3e9-bcf37a0ee62f.ab32f2567a6620ff7888f2e4e99206e0.jpeg",
"price": 25.48,
"price_display": "$25.48",
"was_price": null,
"savings_amount": null,
"savings_text": null,
"price_type": null,
"unit_price": "$0.02/sft",
"price_range": "From $25.48",
"currency": "USD",
"availability": "IN_STOCK",
"availability_text": "In stock",
"fulfillment": [
"PICKUP",
"DELIVERY",
"SHIPPING"
],
"pickup_club_id": "6372",
"rating": 4.74,
"review_count": 8853,
"department": null,
"product_type": "Paper Towels",
"category_path_id": "100001:450203:1340129:1110179",
"snap_eligible": false,
"badges": [
"Shipping",
"Pickup",
"Delivery as soon as 1 hour"
],
"promotions": [],
"sponsored": false,
"grid_position": 7,
"rank": 3
}
],
"sponsored": [
{
"item_id": "15386268178",
"product_id": "37C5HDIR8ZZP",
"name": "Marathon Centerpull Premium 1-Ply White Paper Towels, 6 rolls, 300 sheets/roll",
"url": "https://www.samsclub.com/ip/Marathon-Centerpull-Premium-1-Ply-White-Paper-Towels-6-rolls-300-sheets-roll/15386268178",
"image": "https://i5.samsclubimages.com/asr/26b91e84-b278-40ff-99fb-4e1ea6a48708.193598f7bae55786d1b0bc6615b430fc.jpeg",
"price": 38.88,
"price_display": "Now $38.88",
"was_price": 40.98,
"savings_amount": 2.1,
"savings_text": "SAVE $2.10",
"price_type": null,
"unit_price": "$0.03/sft",
"price_range": null,
"currency": "USD",
"availability": "IN_STOCK",
"availability_text": "In stock",
"fulfillment": [
"PICKUP",
"DELIVERY",
"SHIPPING"
],
"pickup_club_id": "6372",
"rating": 4.55,
"review_count": 947,
"department": "Household Essentials",
"product_type": "Paper Towels",
"category_path_id": "450203:1340129:1110179",
"snap_eligible": false,
"badges": [
"Shipping",
"Pickup",
"Delivery as soon as 1 hour"
],
"promotions": [
"Instant Savings"
],
"sponsored": true,
"grid_position": 1,
"rank": 1
},
{
"item_id": "15325822107",
"product_id": "1GR54ZHJWFQA",
"name": "Marathon Automated Hardwound Paper Towel Dispenser, Black",
"url": "https://www.samsclub.com/ip/Marathon-Automated-Hardwound-Paper-Towel-Dispenser-Black/15325822107",
"image": "https://i5.samsclubimages.com/asr/35704e51-54dd-481c-9f49-227e7c51f7e3.5e03daee1065c97b05b022f52f6c1a1b.jpeg",
"price": 47.46,
"price_display": "$47.46",
"was_price": null,
"savings_amount": null,
"savings_text": null,
"price_type": null,
"unit_price": "$47.46/ea",
"price_range": null,
"currency": "USD",
"availability": "IN_STOCK",
"availability_text": "In stock",
"fulfillment": [
"SHIPPING"
],
"pickup_club_id": null,
"rating": 4.63,
"review_count": 240,
"department": "Household Essentials",
"product_type": "Paper Towel Holders",
"category_path_id": "450203:1340129:1110179",
"snap_eligible": false,
"badges": [
"Shipping"
],
"promotions": [],
"sponsored": true,
"grid_position": 2,
"rank": 2
},
{
"item_id": "13763953249",
"product_id": "12E83O8E7KDG",
"name": "Marathon Multifold 1-Ply White Paper Towels 16 pks., 250 towels/pk",
"url": "https://www.samsclub.com/ip/Marathon-Multifold-1-Ply-White-Paper-Towels-16-pks-250-towels-pk/13763953249",
"image": "https://i5.samsclubimages.com/asr/7737caf1-41b8-4e03-8be9-8ce3d686b921.c906b30326cb2493e5604fbcb5b05dcb.jpeg",
"price": 32.98,
"price_display": "Now $32.98",
"was_price": 33.98,
"savings_amount": 1,
"savings_text": "SAVE $1.00",
"price_type": null,
"unit_price": "$0.01/sft",
"price_range": null,
"currency": "USD",
"availability": "IN_STOCK",
"availability_text": "In stock",
"fulfillment": [
"PICKUP",
"DELIVERY",
"SHIPPING"
],
"pickup_club_id": "6372",
"rating": 4.64,
"review_count": 2911,
"department": "Professional Cleaning",
"product_type": "Paper Towels",
"category_path_id": "2151:15720533:1553",
"snap_eligible": false,
"badges": [
"Shipping",
"Pickup",
"Delivery as soon as 1 hour"
],
"promotions": [
"Instant Savings"
],
"sponsored": true,
"grid_position": 5,
"rank": 3
}
],
"total": 14,
"total_is_exact": true,
"total_reported_by_site": 19,
"pagination": {
"page": 1,
"last_page": 1,
"has_more": false
},
"club": {
"club_id": "6372",
"postal_code": "75231",
"state": "TX",
"source": "site_default"
},
"store_defaulted": true,
"query": {
"query": "paper towels",
"page": 1,
"sort": "best_match",
"min_price": null,
"max_price": null
}
}
}What the Sam's Club API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search samsclub.com by keyword with the site's own sort and price filter. Rows carry the card price, was-price and Instant Savings, unit price, stock status, pickup/delivery/shipping flags, rating and review count and SNAP flag; the site's paid tiles come in a separate `sponsored` list. Prices are the site's default club (named in `data.club`, `store_defaulted: true`); use `product` with `club_id` for another club's price. | Pricing teams call search to search samsclub.com by keyword with the site's own sort and price filter. | query, page, sort, min_price, max_price |
| product | One Sam's Club item in full for a chosen club (or the site's default club): headline price plus the in-club, delivery and shipping price separately, was-price and savings, unit price, stock per fulfillment option with the in-club quantity, aisle location, item number, UPC, brand, model, specifications, description, images, rating breakdown and top reviews. | Marketplace operators call product to get one Sam's Club item in full for a chosen club (or the site's default club). | item_id, club_id |
| clubs | Sam's Club clubs near a US ZIP code, nearest first: club number, name, address, distance, time zone, pickup services and opening hours. | Catalog enrichment teams call clubs to get sam's Club clubs near a US ZIP code, nearest first. | zip_code |
| club_availability | Which Sam's Club clubs near a ZIP code have one item in stock (the site's own 'check other clubs' answer), nearest first. | Retail analysts call club_availability to get which Sam's Club clubs near a ZIP code have one item in stock (the site's own 'check other cl…. | item_id, zip_code, limit |
Call search from your stack
curl -X POST https://api.reefapi.com/samsclub/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"paper towels"}'import requests
r = requests.post(
"https://api.reefapi.com/samsclub/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "paper towels"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/samsclub/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "paper towels"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.samsclub.search with {"query":"paper towels"}.Who uses this API and why
- Compare Sam's Club in-club prices between clubs and against Costco and Walmart.
- Track Instant Savings and price drops on the products you sell or buy in bulk.
- Check which nearby clubs have an item in stock before sending a buyer.
- Build a Sam's Club product database with UPC, item number, model and specifications.
- Map every Sam's Club near a set of ZIP codes with hours and pickup services.
Questions developers ask before integrating
Do I need a Sam's Club membership or account?
No. Everything is what a logged-out visitor sees on samsclub.com: prices including member Instant Savings, stock, clubs and reviews.
Can I get prices for a specific club?
Yes, for items: product takes club_id (from the clubs call) and returns that club's in-club price, stock count and aisle. Search returns Sam's Club's default club (Dallas Timber Creek Crossing, TX 75231) and names it on every response.
What is the difference between the in-club and the shipping price?
They are set separately and can differ a lot: one LG OLED TV was $599.91 in club and $1,349.91 shipped on the same day. product returns both, plus the delivery price.
Does it show Instant Savings?
Yes. Discounted items carry was_price, savings_amount and the site's own "SAVE $" text, and price_type MEMBER when it is a member Instant Savings price.
How do I find which clubs have an item in stock?
club_availability with the item_id and a ZIP code returns the nearest clubs (up to 20) with IN_STOCK or OUT_OF_STOCK for that item, nearest first.
Which filters and sorts work?
min_price and max_price ("chicken": 166 results, 13 between $20 and $30) and sort by best match, price low to high or price high to low. Other sort orders the site lists returned the best-match order and are not offered.
How many results can I page through?
About 40-45 products per page plus the paid tiles, which come apart; "chicken" ran to 4 pages and "coffee" to 7, with no product repeated across pages 1-3. A page past the last returns nothing.
How fresh is the data?
Every call reads samsclub.com live; nothing is cached.
What is the Sam's Club API?
Sam's Club API is a ReefAPI endpoint group for sam's club prices, instant savings, in-club stock and aisle by club, plus club finder and per-club availability. It returns live JSON through POST requests under /samsclub/v1.
Is the Sam's Club API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Sam's Club calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Sam's Club login or account?
No login to Sam's Club is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Sam's Club data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Sam's Club API use?
Sam's Club actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Sam's Club from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call samsclub actions with the same key, credit pool and JSON envelope used by normal REST requests.