Costco · live

Costco product data, one call away.

Price and regular price, stock, rating, brand, membership requirement and delivery programs, by item or product number.

item or product numbers per credit · $3.50 a credit: ≈1.4 millionitem or product numbers per credit · $3.50 a credit
item or product numbers per call: 500item or product numbers per call
typical call, 500 ids: 15–30 stypical call, 500 ids

In practice

One Costco call

Up to 500 item or product numbers a call, about 1.4 million per credit. Values are illustrative.

request

curl -X POST "https://api.scrapelyserp.com/v1/products" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"costco","marketplace":"us","ids":["1936928","1944847"]}'

response

{
  "platform": "costco",
  "marketplace": "us",
  "tier": "standard",
  "results": [
    {
      "id": "1936928",
      "status": "ok",
      "fetchedAt": "2026-10-16T14:02:11.482Z",
      "title": "Stainless steel pour-over kettle, 1 L",
      "price": {
        "amount": 34.99,
        "currency": "USD"
      },
      "availability": {
        "inStock": true,
        "message": "In stock"
      }
    },
    {
      "id": "1944847",
      "status": "ok",
      "fetchedAt": "2026-10-16T14:02:11.482Z",
      "title": "Non-slip yoga mat, 6 mm",
      "price": {
        "amount": 21.5,
        "currency": "USD"
      },
      "availability": {
        "inStock": true,
        "message": "In stock"
      }
    }
  ],
  "stats": {
    "requested": 2,
    "ok": 2,
    "partial": 0,
    "notFound": 0,
    "unavailable": 0,
    "elapsedMs": 1840
  },
  "credits": 0.0000014285714285714286
}

What it returns

The shared fields, plus Costco's own

Every result carries the fields every platform shares — id, status, title, price with its currency, availability — and what only Costco publishes on top.

Marketplaces

US (live)

Title
Price and regular price
Sale flag
Stock
Rating and review count
Brand and manufacturer
Membership requirement
Delivery programs
Variant attributes
Images

Pricing

One tier, every field

One credit costs $3.50: each call spends credits in proportion to the data it moves, and requests that fail cost nothing. Items per credit are typical.

Costco tiers: items per credit, cost per million, items per call and typical call time
Tier	item or product numbers / credit	1M item or product numbers	Per call	Typical call
"standard"Title, current and regular price, stock, rating, brand, membership requirement, delivery programs and variant attributes.	≈ 1.4 million	$2.50	500	15–30 s for 500 ids

okmetered
Product returned cleanly. Use it.
partialmetered
Some fields could not be read. Retry, or re-fetch at a higher tier where there is one.
not_foundmetered
Costco says the item or product number does not exist. Delist it.
unavailablefree
No answer this time, so nothing to pay. Retry later; not evidence it is dead.

Watch Costco item or product numbers

A watchlist checks your item or product numbers on your cadence, about 1.4 million a credit, and sends a signed webhook for every change to price, stock or seller — the same events as on every other retailer.

How watchlists work

FAQ

Costco questions

Which Costco marketplaces are supported?

Costco US ("us", USD) today. "marketplace": "us" is the default.

What item or product number do I send?

The digits of a Costco item number or product number (a product link is accepted), e.g. 1936928. Send them as "ids". Duplicates are fetched once; anything that is not an item or product number is rejected with a 400 before anything is charged.

How is it billed?

In credits, at $3.50 a credit: every call spends credits in proportion to the data it moves. Standard covers about 1.4 million item or product numbers a credit, up to 500 a call. A request that fails costs nothing, and the response tells you the credits each call used.

Can I watch Costco items?

Yes. Create a watchlist with "platform": "costco" and your item or product numbers; each run is billed the credits its calls spend, like any other call, and sends a signed webhook for every change, in the same event format as every other retailer.

Same API, same response shape

Start pulling
product data

Create an account, buy a credit pack and fetch products from any live retailer. No subscription, and what you buy never expires.

Get startedTalk to us about your catalogue

POST api.scrapelyserp.com/v1/products { "platform", "marketplace", "ids": […] }

Costco product data, one call away.Costco product data, one call away.