Costco

API de catégorie Costco

Les produits d'une catégorie Costco en JSON, avec le même tri, les mêmes filtres et les mêmes prix par entrepôt que la recherche : prix en ligne, note et nombre d'avis, indicateurs réservé aux membres et stock, promotions et facettes. Les slugs de catégorie proviennent de l'endpoint Categories. Coûte 2 crédits par requête sur costco.com, 1 sur costco.ca.

POST/api/v1/costco/category

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

categorystringrequired

Slug de catégorie obtenu avec l'endpoint Categories, ou URL de catégorie costco.com.

Example: televisions

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 le prix en entrepôt, l'état du stock et le code de prix de cet entrepôt à chaque résultat. Omettez-le pour les prix en ligne seulement. 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, de 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

Masque 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, de 1 à 500.

Example: 2

page_sizeintegerdefault:24

Résultats par page, de 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")

results = client.costco.category("televisions", sort_by="price_low", page_size=5)

for item in results["data"]["results"]:
    print(item["item_number"], item["title"], item["price"], item["member_only"])

Response

"country": "us",

"query": null,

"category": "televisions",

"redirected_to_category": null,

"corrected_query": null,

"warehouse_id": null,

"total_results": 39,

"page": 1,

"page_size": 5,

"total_pages": 8,

"count": 5,

"response_time": 2856

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") results = client.costco.category("televisions", sort_by="price_low", page_size=5) for item in results["data"]["results"]: print(item["item_number"], item["title"], item["price"], item["member_only"])