To get Sam's Club product data programmatically, use Scavio's Sam's Club API. POST /api/v1/samsclub/clubs turns a ZIP code into club ids, and POST /api/v1/samsclub/product with an item_id and club_id returns that club's shelf price next to the online price, whether the club has the item on the shelf, the aisle, and stock for pickup, delivery and shipping. /search, /savings and /category list products with Instant Savings and their end dates, and /reviews returns member reviews. Every call costs 1 credit, about $0.002 on the Growth plan billed yearly.
Sam's Club has no public catalog API. Its developer portal is for suppliers managing advertising, so it is the wrong tool for reading a club's price or stock.
Step 1: Find the club
curl -s https://api.scavio.dev/api/v1/samsclub/clubs \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"zip": "75201", "limit": 3}'On October 31, 2026 the nearest club to downtown Dallas came back first, as captured (trimmed: Saturday and Sunday hours removed):
{
"club_id": "4925",
"name": "Dallas, Greenville Sam's Club",
"address": {
"line1": "2218 Greenville, Ave",
"city": "Dallas",
"state": "TX",
"zipcode": "75206",
"county": "DALLAS",
"country": "US"
},
"latitude": 32.816724,
"longitude": -96.769512,
"distance_miles": 2.57,
"phone": "469 329 5388",
"time_zone": "CST",
"hours": {
"monday_friday": { "open": "10:00", "close": "20:00", "closed": false }
},
"services": [],
"temporarily_closed": false
}Up to 20 clubs within 100 miles come back, nearest first. Keep the club_id; step 3 needs it.
Step 2: Search products
curl -s https://api.scavio.dev/api/v1/samsclub/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "coffee"}'"coffee" returned 65 rows on page 1: 47 search results (287 in all, over 7 pages) and 18 from Sam's Club's "You might also like" and category carousels. section tells them apart, so filter on it if you only want the search results. One row, as captured (image URL removed):
{
"position": 1,
"item_id": "88133400961",
"title": "Dunkin' Donuts Medium Roast K-Cup Coffee Pods, Original Blend, 72 ct.",
"url": "https://www.samsclub.com/ip/Dunkin-Donuts-Medium-Roast-K-Cup-Coffee-Pods-Original-Blend-72-ct/88133400961?classType=REGULAR",
"price": 45.88,
"was_price": null,
"savings_amount": null,
"unit_price": "63.7 ¢/ea",
"currency": "USD",
"rating": 4.8059,
"review_count": 9670,
"sponsored": true,
"out_of_stock": false,
"availability_status": "In stock",
"fulfillment": { "pickup": true, "delivery": true, "shipping": true },
"aisle": "F11",
"instant_savings": null,
"badge": null,
"section": "\"coffee\""
}Read data.club before you use these prices. Search, Instant Savings and category are priced and stocked at a club Sam's Club picks by location, and nothing you send changes it: this call used the Dallas, Timber Creek Crossing club (6372), and other calls the same day used Lombard, Illinois and Los Angeles. The $45.88 above is a club shelf price; the same pods were $47.68 online. sponsored marks ads.
Step 3: Price and stock at your club
curl -s https://api.scavio.dev/api/v1/samsclub/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"item_id": "3570007820", "club_id": "4925"}'Item 3570007820 is Community Coffee Medium Roast Ground Coffee, Breakfast Blend, 40 oz. The captured response, trimmed to the price and stock fields (images, specifications, descriptions, and the delivery channel price and option removed):
{
"item_id": "3570007820",
"title": "Community Coffee Medium Roast Ground Coffee, Breakfast Blend, 40 oz.",
"price": 21.48,
"club_price": {
"price": 15.91,
"was_price": null,
"savings_amount": null,
"unit_price": { "price": 0.398, "display": "39.8 ¢/oz" }
},
"channel_prices": [
{ "channel": "shipping", "store_front": "online", "price": 21.48, "was_price": null, "savings_amount": null, "unit_price": { "price": 0.537, "display": "53.7 ¢/oz" } },
{ "channel": "pickup", "store_front": "physical", "price": 15.91, "was_price": null, "savings_amount": null, "unit_price": { "price": 0.398, "display": "39.8 ¢/oz" } }
],
"member_limit": null,
"order_limit": 12,
"club": { "club_id": "4925", "city": "Dallas", "state": "TX", "zipcode": "75206" },
"in_stock_at_club": true,
"aisle": "B6",
"fulfillment": {
"pickup": true,
"delivery": true,
"shipping": true,
"options": [
{
"method": "shipping",
"available": true,
"availability_status": "IN_STOCK",
"available_quantity": 8,
"max_order_quantity": 12,
"location": "Dallas, 75206",
"aisle": null,
"estimated_date": "2026-11-02T22:59:00.000Z",
"fee": null
},
{
"method": "pickup",
"available": true,
"availability_status": "IN_STOCK",
"available_quantity": 8,
"max_order_quantity": 12,
"location": "Dallas, Greenville Sam's Club",
"aisle": "B6",
"estimated_date": "2026-10-31T15:00:00.000-05:00",
"fee": null
}
]
}
}price is samsclub.com shipped, club_price is this club's shelf: $15.91 against $21.48, 26% less. The same call with club_id 6643 returned $13.98 at the Atlanta club, but with in_stock_at_club: false and pickup OUT_OF_STOCK. Three things to handle:
available_quantityis capped at 8. 8 means 8 or more, never an exact count.- Fresh items have regional ids. The Member's Mark whole milk gallon (16518858557) priced at $3.88 in Dallas and $4.08 in Doral and Atlanta, and came back not found at Cicero, South Gate and Tempe. A not-found item is not charged.
- The
unit_priceshape differs. Listings return it as a string ("63.7 ¢/ea"); product returns an object with a numericpriceand adisplaystring.
Across 18 items at six clubs we found 14 club prices below the online price and none above, so for a price tracker the shelf price is the number to store.
Step 4: List every Instant Savings offer
curl -s https://api.scavio.dev/api/v1/samsclub/savings \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sort": "top_selling"}'This returned 3,453 items over 77 pages at the Los Angeles club Sam's Club picked. The top seller, as captured and trimmed to the price and offer fields:
{
"item_id": "81162002218",
"title": "Fairlife Nutrition Plan 30g Protein Shake, Chocolate, 11.5 fl. oz., 12 pk.",
"price": 21.28,
"was_price": 26.78,
"savings_amount": 5.5,
"unit_price": "19.4 ¢/fl oz",
"availability_status": "In stock",
"fulfillment": { "pickup": true, "delivery": true, "shipping": true },
"instant_savings": {
"promotion_id": "0ee5f674-10b3-438e-b968-db3a5a0fc64f",
"title": "Instant Savings",
"message": "$5.50 off",
"amount": 5.5,
"end_date": "Nov 09",
"limit": 5,
"limit_text": "Limit 5"
}
}end_date is Sam's Club's own short text, so store it as given. On the first page, 35 of 45 offers ended "Nov 29" and the largest saving was $9 on Starbucks Pike Place K-Cup pods, $35.98 against $44.98.
Step 5: Browse clearance or any category
curl -s https://api.scavio.dev/api/v1/samsclub/category \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id": "1150109", "sort": "price_low"}'Clearance is category 1150109. It returned 138 items over 4 pages at the Dallas, Timber Creek Crossing club, in the same row format as search. 26 of the 42 rows on page 1 were out of stock, so filter on availability_status before you alert anyone. Any other category id comes from the number at the end of a samsclub.com /browse/ or /cp/ URL.
Step 6: Read member reviews
curl -s https://api.scavio.dev/api/v1/samsclub/reviews \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"item_id": "18040450426", "sort": "most_helpful"}'The summary arrives with every page:
{
"item_id": "18040450426",
"sort": "most_helpful",
"average_rating": 4.800964630225081,
"total_review_count": 3110,
"reviews_with_text_count": 359,
"recommended_percentage": 91,
"rating_breakdown": { "1": 39, "2": 27, "3": 70, "4": 242, "5": 2732 },
"count": 10
}reviews[] holds 10 reviews with rating, title, text, author, date, verified_purchase and helpful votes, plus top_positive_review and top_negative_review. The sort value is most_helpful; the others are newest, oldest, highest and lowest. For these Bounty paper towels, rated 4.8, the two most helpful reviews were both 1-star complaints about roll size and glue.
All six endpoints
| Endpoint | What it returns | Credits |
|---|---|---|
/api/v1/samsclub/product | Online and club price, channel prices, stock, quantity and aisle at the club you pass, limits, rating breakdown, specs | 1 |
/api/v1/samsclub/clubs | Clubs near a ZIP with club id, address, coordinates, distance, phone, hours, services | 1 |
/api/v1/samsclub/search | Products with price, unit price, Instant Savings, rating, stock, fulfillment and aisle | 1 |
/api/v1/samsclub/savings | Every Instant Savings item with amount, end date and limit | 1 |
/api/v1/samsclub/category | Products in a category; clearance is 1150109 | 1 |
/api/v1/samsclub/reviews | 10 reviews a page, star breakdown, top positive and negative review | 1 |
For a side-by-side of every option, see the best Sam's Club product data APIs. For stock checks club by club, see checking Sam's Club inventory by club.
Getting started
- Sign up at dashboard.scavio.dev/sign-up: 50 free credits, no card required.
- Copy your API key from the dashboard.
- Send a POST to
/api/v1/samsclub/clubswith your ZIP, then to/api/v1/samsclub/productwith an item id and the club id.
Try the Sam's Club API free in the playground first, or call it from Claude and other agents through the MCP server.
Reference: Sam's Club API overview · product · clubs · search · savings · category · reviews
Frequently asked questions
Does Sam's Club have an API for product data?
Not a public one. The Sam's Club developer portal serves suppliers who onboard as advertisers and manage ad campaigns. Scavio's Sam's Club API returns the public samsclub.com data as JSON with one API key: search, product detail with a club's shelf price and stock, a club locator, Instant Savings, categories including clearance, and reviews.
How do I get the price at a specific Sam's Club?
Call /api/v1/samsclub/clubs with a ZIP code to get nearby club ids, then pass item_id and club_id to /api/v1/samsclub/product. club_price is that club's shelf price and price is the online price. On October 31, 2026, Community Coffee Breakfast Blend, 40 oz was $15.91 at the Dallas, Greenville club and $21.48 online.
Why does Sam's Club stock never show more than 8?
Sam's Club caps the quantity it reports at 8, so available_quantity 8 means 8 or more. Use it as a signal that the club has plenty, and use availability_status and in_stock_at_club for whether the item is on the shelf at all.
How do I get Sam's Club Instant Savings with end dates?
Page /api/v1/samsclub/savings. Each item carries price, was_price and savings_amount, and an instant_savings object with the offer amount, end_date and purchase limit. On October 31, 2026 it listed 3,453 items over 77 pages, and 35 of the 45 offers on the first page ended Nov 29.
How much does Sam's Club data cost with Scavio?
Every Sam's Club endpoint costs 1 credit: about $0.002 on the Growth plan billed yearly and $0.0043 on the $30 monthly Project plan. A not-found item is not charged. New accounts get 50 free credits with no card.