> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentkey.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Sam's Club product data for AI agents

> Search Sam's Club by keyword with sort and price filters, and read a product's member price, stock, brand, model number and UPC by page URL through AgentKey.

Sam's Club is a warehouse club: bulk packs and member pricing, where the
price per unit matters more than the shelf price and the research question is
usually "what does the club charge for this, and is it in stock?" rather than
"who sells it?". samsclub.com blocks automated browsing, and there is no
public product API to fall back on. Through AgentKey your agent reads public
Sam's Club listings the same way it reads everything else — `find_tools`,
`describe_tool`, `execute_tool` — search and product pages, with the member
price on each.

## What you can ask

* *"What is the member price for this pack of paper towels at Sam's Club, and is it in stock?"*
* *"Search Sam's Club for K-cup pods, cheapest first, and work out the price per pod from the pack size."*
* *"Find 65-inch TVs on Sam's Club under 800 dollars and list their ratings."*
* *"Open this Sam's Club product page — member price, stock, brand, model number and UPC."*
* *"Which of these Sam's Club results are in stock right now?"*
* *"Is the Sam's Club member price on this TV lower than Best Buy's price for the same model number?"*
* *"Sam's Club 上这款纸巾的会员价是多少，有货吗？"*

## What's covered

**Search**

* Keyword search with page controls and a price range
* Sort by best match or by price, low to high or high to low
* Title, member price, stock and rating for each result

**Product details**

* One product by its page URL — title, member price, stock, brand, model
  number, UPC, rating, description and images

**Club and currency**

* Coverage is samsclub.com, Sam's Club's US site, priced in US dollars
* Prices and stock are those of the site's default club; the tools take no
  club or ZIP code

Not covered today: customer reviews. For review research on a comparable
item, pair this page with
[Walmart](https://docs.agentkey.app/capabilities/ecommerce/walmart-product-data-for-ai-agents.md) or
[Best Buy](https://docs.agentkey.app/capabilities/ecommerce/best-buy-product-data-for-ai-agents.md), which
carry customer reviews; Best Buy's product details also return the model
number and UPC, so the same TV can be matched across the two.

## How to use it

Pass the request in plain language and let the router pick the tool:

```text theme={null}
find_tools(q="member price and stock for this Sam's Club paper towel pack")
find_tools(q="Sam's Club 上这款纸巾的会员价")
find_tools(prefix="ecommerce/sams-club")    # browse everything for Sam's Club
describe_tool("<returned Provider/Operation>")
execute_tool("<Provider/Operation>", { ...params })
```

The product tool takes the product page URL, and search results carry it, so
search → product needs no manual parsing. Prices come back as samsclub.com
shows them — the member price, in US dollars, for the site's default club —
not converted. Always `describe_tool` before executing: it shows the accepted
sort values, the page limits, and the per-call cost.

> [!NOTE]
>
> **Building with code?** Sam's Club is available through the catalog tools
> above only; there are no fixed-contract Scenario Methods for it yet. See the
> [Scenario Methods overview](https://docs.agentkey.app/api-reference/scenario/overview.md) for the
> platforms that have them.

## FAQ

> [accordion] Do I need a Sam's Club membership?
>
> No. AgentKey holds the upstream access; your agent only needs your AgentKey
> subscription. Member prices come back as the site shows them.

> [accordion] Can it place an order or check my local club's shelf?
>
> No. Every tool is read-only — search and product details — and stock is
> what samsclub.com shows online, not the shelf of a particular club near
> you.

> [accordion] Which club do the prices and stock come from?
>
> The site's default club. The tools take no club or ZIP code, so member
> prices and stock are what samsclub.com shows before a club is chosen; the
> shelf at a club near you can differ.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.