Costco

Costco Deals API

Costco deal feeds as JSON: new items, while supplies last, treasure hunt, member favorites, online-only and everything on sale, with the same sort and filters as search and optional per-warehouse pricing. Costs 1 credit per request.

POST/api/v1/costco/deals

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

typeenum<string>required

Which deal feed to read.

Example: while_supplies_last

new — New items.
while_supplies_last — While supplies last.
treasure_hunt — Treasure hunt items.
member_favorites — Member favorites.
online_only — Online-only offers.
on_sale — Everything with an active discount.

countryenum<string>default:us

costco.com (us) or costco.ca (ca).

Example: ca

us — costco.com, United States.
ca — costco.ca, Canada.

warehouse_idstring

Costco warehouse number from the Warehouses endpoint. Adds that warehouse's in-store price, stock status and price code to every result. Omit for online prices only. us and ca only.

Example: 1062

sort_byenum<string>default:best_match

Result order. Costco broadens matching under any sort other than best_match. newest is not available on uk, au, mx, jp, kr or tw.

Example: price_low

best_match — Costco's relevance ranking.
price_low — Price, lowest first.
price_high — Price, highest first.
top_rated — Highest average rating first.
newest — Newest items first (us and ca).

brandsarray<string>

Only these brands, up to 20 names, e.g. ["Kirkland Signature"]. us and ca only.

Example: ["Kirkland Signature"]

min_pricenumber

Minimum online price, inclusive, 0 or greater. us and ca only.

Example: 10

max_pricenumber

Maximum online price, inclusive, 0 or greater. us and ca only.

Example: 50

min_ratingnumber

Minimum average star rating, 1-5. us and ca only.

Example: 4

on_saleboolean

Only items with an active discount. us and ca only.

Example: true

in_stockboolean

Hide out-of-stock items. us and ca only.

Example: true

in_warehouseboolean

Only items sold and in stock at warehouse_id. Requires warehouse_id.

Example: true

pageintegerdefault:1

Results page, 1-based, 1-500.

Example: 2

page_sizeintegerdefault:24

Results per page, 1-120 (up to 100 on uk, au, mx, jp, kr and tw).

Example: 48

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

deals = client.costco.deals("treasure_hunt", warehouse_id="1062", sort_by="price_low")

for item in deals["data"]["results"]:
    print(item["item_number"], item["title"], item["price"], item.get("warehouse"))

Response

"type": "while_supplies_last",

"country": "us",

"query": "whilesupplieslast",

"category": null,

"redirected_to_category": null,

"corrected_query": null,

"warehouse_id": null,

"total_results": 12,

"page": 1,

"page_size": 5,

"total_pages": 3,

"count": 5,

"response_time": 1844

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") deals = client.costco.deals("treasure_hunt", warehouse_id="1062", sort_by="price_low") for item in deals["data"]["results"]: print(item["item_number"], item["title"], item["price"], item.get("warehouse"))