Costco

API des aubaines Costco

Les fils d'aubaines Costco en JSON : nouveautés, jusqu'à épuisement des stocks, trouvailles (treasure hunt), favoris des membres, exclusivités en ligne et tout ce qui est en solde, avec le même tri et les mêmes filtres que la recherche, et les prix par entrepôt en option. Coûte 2 crédits par requête sur costco.com, 1 sur costco.ca.

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

Le fil d'aubaines à lire.

Example: while_supplies_last

new — Nouveautés.
while_supplies_last — Jusqu'à épuisement des stocks.
treasure_hunt — Trouvailles (treasure hunt).
member_favorites — Favoris des membres.
online_only — Offres exclusives en ligne.
on_sale — Tout ce qui a un rabais actif.

countryenum<string>default:us

costco.com (us) ou costco.ca (ca).

Example: ca

us — costco.com, États-Unis.
ca — costco.ca, Canada.

warehouse_idstring

Numéro d'entrepôt Costco obtenu avec l'endpoint Warehouses. Ajoute à chaque résultat le prix en entrepôt, l'état du stock et le code de prix de cet entrepôt. Omettez-le pour obtenir seulement les prix en ligne. us et ca seulement.

Example: 1062

sort_byenum<string>default:best_match

Ordre des résultats. Costco élargit la correspondance avec tout tri autre que best_match. newest n'est pas offert sur uk, au, mx, jp, kr ni tw.

Example: price_low

best_match — Classement par pertinence de Costco.
price_low — Prix, du plus bas au plus élevé.
price_high — Prix, du plus élevé au plus bas.
top_rated — Meilleure note moyenne en premier.
newest — Articles les plus récents en premier (us et ca).

brandsarray<string>

Seulement ces marques, jusqu'à 20 noms, p. ex. ["Kirkland Signature"]. us et ca seulement.

Example: ["Kirkland Signature"]

min_pricenumber

Prix en ligne minimal, inclus, 0 ou plus. us et ca seulement.

Example: 10

max_pricenumber

Prix en ligne maximal, inclus, 0 ou plus. us et ca seulement.

Example: 50

min_ratingnumber

Note moyenne minimale en étoiles, 1-5. us et ca seulement.

Example: 4

on_saleboolean

Seulement les articles avec un rabais actif. us et ca seulement.

Example: true

in_stockboolean

Masquer les articles en rupture de stock. us et ca seulement.

Example: true

in_warehouseboolean

Seulement les articles vendus et en stock à l'entrepôt warehouse_id. Exige warehouse_id.

Example: true

pageintegerdefault:1

Page de résultats, à partir de 1, 1-500.

Example: 2

page_sizeintegerdefault:24

Résultats par page, 1-120 (jusqu'à 100 sur uk, au, mx, jp, kr et 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"))