Skip to main content
Scrape Costco product search

Authorizations

x-scrapeunblocker-key
string
header
required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

query
string
required

What to search for, e.g. 'paper towels', 'kirkland coffee' or 'tv'.

sort
string
default:relevance

Result order: relevance, price_low, price_high, rating, newest, brand.

page
integer
default:1

1-based results page to start from (24 products per page, as on costco.com).

max_results
integer
default:24

Products to collect from page on, 1-240. Up to 120 are billed as one request.

include_out_of_stock
boolean
default:false

Also return products that are out of stock (Costco hides them by default).

domain
string
default:com

Costco storefront: com, ca ('com' is costco.com, 'ca' is costco.ca).

proxy_country
string | null

Proxy country the request is sent from (ISO-2, e.g. 'US'). Leave blank to let the API pick. Costco computes availability for the delivery location it derives from the visitor; it is named in deliveryLocation.

Response

JSON with a products array. A search with no matches answers 200 with an empty products list.