Costco

API de recherche Costco

Cherchez sur Costco par mot-clé ou par numéro d'article et recevez des lignes de produits structurées en JSON : prix en ligne et prix d'origine, note et nombre d'avis, indicateurs réservé aux membres et stock, promotions et facettes. Ajoutez warehouse_id pour obtenir le prix en entrepôt, l'état du stock et le code de prix de cet entrepôt dans chaque résultat. Coûte 2 crédits par requête sur costco.com, 1 sur costco.ca et les sites internationaux.

POST/api/v1/costco/search

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

querystringrequired

Mots-clés ou numéro d'article Costco, de 1 à 200 caractères.

Example: olive oil

countryenum<string>default:us

Site Costco. us et ca acceptent tous les paramètres; uk, au, mx, jp, kr et tw acceptent seulement le mot-clé, le tri et la pagination.

Example: uk

us — costco.com, États-Unis.
ca — costco.ca, Canada.
uk — Royaume-Uni.
au — Australie.
mx — Mexique.
jp — Japon.
kr — Corée du Sud.
tw — Taïwan.

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")

# warehouse_id ajoute le prix en entrepôt et le code de prix à chaque ligne
results = client.costco.search("olive oil", warehouse_id="1062", page_size=5)

for item in results["data"]["results"]:
    store = item.get("warehouse") or {}
    print(item["item_number"], item["title"], item["price"], store.get("price"))

Response

"country": "us",

"query": "olive oil",

"category": null,

"redirected_to_category": null,

"corrected_query": null,

"warehouse_id": "1062",

"total_results": 106,

"page": 1,

"page_size": 5,

"total_pages": 22,

"count": 5,

"response_time": 3357

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # warehouse_id ajoute le prix en entrepôt et le code de prix à chaque ligne results = client.costco.search("olive oil", warehouse_id="1062", page_size=5) for item in results["data"]["results"]: store = item.get("warehouse") or {} print(item["item_number"], item["title"], item["price"], store.get("price"))