Pour obtenir les prix Costco d'un entrepôt du Québec par API, trouvez d'abord l'identifiant de l'entrepôt avec /api/v1/costco/warehouses, puis envoyez un POST à https://api.scavio.dev/api/v1/costco/prices avec un numéro d'article, jusqu'à 10 warehouse_ids et "country": "ca". La réponse place le prix de costco.ca à côté du prix en rayon de chaque entrepôt, en dollars canadiens, pour 1 crédit jusqu'à 9 entrepôts. La même clé donne le stock par entrepôt, l'essence, les aubaines et les liquidations.
Toutes les réponses de ce guide ont été capturées le 2 novembre 2026.
Ce qu'il vous faut
- Une clé API Scavio. L'inscription donne 50 crédits gratuits, sans carte et sans abonnement Costco.
- N'importe quel langage capable d'envoyer une requête HTTP. Les exemples utilisent cURL et Python.
Étape 1 : trouvez vos entrepôts
Le code ZIP est réservé aux États-Unis : au Canada, envoyez des coordonnées.
curl -X POST 'https://api.scavio.dev/api/v1/costco/warehouses' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"latitude": 45.5017, "longitude": -73.5673, "limit": 12, "country": "ca"}'Depuis le centre-ville de Montréal, la réponse a listé 12 entrepôts, de Montréal (515) à Terrebonne (525), en passant par Brossard, Anjou, Laval et Pointe-Claire. Chaque entrepôt arrive avec ses heures, ses rayons, ses services et le prix de l'essence de son poste. Premier résultat, réduit :
{
"warehouse_id": "515",
"name": "Montreal",
"address": {
"line1": "300 RUE BRIDGE",
"city": "MONTREAL",
"state": "QC",
"zip": "H3K 2C3",
"country": "CA"
},
"distance_miles": 2.07,
"hours": ["Mon-Fri. 09:00AM - 08:30PM", "Sat. 09:00AM - 07:00PM", "Sun. 09:00AM - 07:00PM"],
"gas_station": {
"hours": ["Mon-Fri. 6:00am - 9:30pm", "Sat. 6:00am - 8:30pm", "Sun. 6:00am - 8:30pm"],
"prices": {"regular": 1.839, "premium": 2.039, "diesel": null}
},
"currency": "CAD"
}La distance est en milles. Sur costco.ca, le localisateur coûte 2 crédits.
Étape 2 : cherchez avec le prix en rayon
Ajoutez warehouse_id à une recherche, et chaque résultat porte le prix de cet entrepôt :
curl -X POST 'https://api.scavio.dev/api/v1/costco/search' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"query": "café", "country": "ca", "warehouse_id": "515"}'« café » a renvoyé 24 produits sur 36. Le premier, réduit aux champs de prix :
{
"item_number": "15071",
"title": "Kirkland Signature Dark Colombian Ground Coffee, 1.36 kg",
"rating": 4.77,
"reviews_count": 9316,
"price": 34.99,
"original_price": 34.99,
"on_sale": false,
"currency": "CAD",
"warehouse": {
"warehouse_id": "515",
"price": 29.99,
"availability": "in_stock",
"price_code": {"ending": "99", "meaning": "regular_price"}
}
}price est le prix de costco.ca; warehouse.price, le prix en rayon à Montréal. Ici, 5 $ de moins en entrepôt. Sur les 18 cafés de cette recherche, 10 étaient moins chers en rayon, 4 plus chers et 4 au même prix. La recherche accepte aussi brands, les filtres de prix et de note, on_sale, in_stock et in_warehouse, et coûte 1 crédit sur costco.ca.
Étape 3 : comparez un article dans plusieurs entrepôts
curl -X POST 'https://api.scavio.dev/api/v1/costco/prices' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"item_id": "15071", "warehouse_ids": ["515", "527", "521", "1446", "1359", "556", "532", "505", "503"], "country": "ca"}'La réponse est arrivée en 3,1 secondes. Réduite à deux des neuf entrepôts :
{
"item_number": "15071",
"found": true,
"online": {"price": 34.99, "discount": 0, "final_price": 34.99, "currency": "CAD", "promotions": []},
"warehouses": [
{"warehouse_id": "515", "available": true, "price": 29.99, "discount": 0, "final_price": 29.99, "currency": "CAD", "promotions": [], "price_code": {"ending": "99", "meaning": "regular_price"}},
{"warehouse_id": "503", "available": true, "price": 29.99, "discount": 0, "final_price": 29.99, "currency": "CAD", "promotions": [], "price_code": {"ending": "99", "meaning": "regular_price"}}
]
}Le café était à 29,99 $ dans les 9 entrepôts, de Montréal à Québec, contre 34,99 $ en ligne. item_ids accepte jusqu'à 20 articles par appel; l'appel coûte 1 crédit jusqu'à 9 entrepôts et 2 pour 10. Passez un numéro d'article (item_number), pas un identifiant de produit : convertissez d'abord ces derniers avec /api/v1/costco/product.
Étape 4 : vérifiez le stock avant de prendre la route
curl -X POST 'https://api.scavio.dev/api/v1/costco/availability' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"item_number": "15071", "warehouse_ids": ["515", "521", "505", "503", "516"], "country": "ca"}'Le paramètre s'appelle ici item_number. Les 5 entrepôts ont répondu "in_warehouse": "in_stock", avec l'état de la livraison le jour même dans channels. C'est un état, jamais un nombre d'unités, et l'appel coûte 1 crédit par tranche de 5 entrepôts.
Étape 5 : lisez le prix de l'essence
curl -X POST 'https://api.scavio.dev/api/v1/costco/gas' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"latitude": 46.8139, "longitude": -71.2080, "country": "ca"}'Depuis le Vieux-Québec, la réponse a listé les 10 postes Costco les plus proches. Le premier :
{
"warehouse_id": "503",
"name": "Quebec",
"address": {"line1": "440 RUE BOUVIER", "city": "QUEBEC", "state": "QC", "zip": "G2J 1E3", "country": "CA"},
"distance_miles": 5.47,
"prices": {"regular": 1.779, "premium": 1.979, "diesel": null},
"hours": ["Mon-Fri. 6:00am - 9:30pm", "Sat. 6:00am - 8:30pm", "Sun. 6:00am - 8:30pm"]
}Les prix sont en dollars le litre : 1,779 $ pour l'ordinaire à Bouvier, à Sainte-Foy et à Lévis. Plus loin dans la même liste, Saint-Hubert affichait 1,669 $ et Anjou 1,819 $. Ajoutez limit pour en garder moins. Une recherche par emplacement coûte 2 crédits sur costco.ca, et 2 crédits par entrepôt si vous passez des warehouse_ids.
Étape 6 : trouvez les liquidations d'un entrepôt
curl -X POST 'https://api.scavio.dev/api/v1/costco/clearance' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"warehouse_id": "515", "query": "café", "country": "ca", "pages": 1}'L'endpoint a analysé 37 produits et en a gardé 2, tous deux des électroménagers de la marque Café à .97 : un réfrigérateur de 36 po à 1 499,97 $ en rayon (6 694,99 $ en ligne) et une cuisinière à induction de 30 po à 1 999,97 $ (3 494,99 $ en ligne), mais les deux étaient out_of_stock à Montréal. Lisez toujours warehouse.availability avant de publier une aubaine. Par défaut, l'analyse garde les codes de liquidation (.97) et de démarque du gérant (.00 et .88); pour inclure aussi les .49, .79 et .89, envoyez "price_codes": ["clearance", "manager_markdown", "special_buy"]. Une analyse coûte 1 crédit, quel que soit pages.
Pour les fils d'aubaines, /api/v1/costco/deals accepte type (new, while_supplies_last, treasure_hunt, member_favorites, online_only, on_sale) et un warehouse_id. Le fil « jusqu'à épuisement des stocks » de Montréal comptait 6 articles, dont 4 à un prix en rayon finissant par .49.
Les 11 endpoints pour costco.ca
| Endpoint | Ce qu'il renvoie | Crédits sur costco.ca |
|---|---|---|
/api/v1/costco/search | Recherche avec prix en ligne, et prix en rayon avec warehouse_id | 1 |
/api/v1/costco/category | Les produits d'une catégorie, mêmes filtres | 1 |
/api/v1/costco/categories | Les rayons et leurs sous-catégories | 1 |
/api/v1/costco/product | Jusqu'à 20 fiches par appel | 1 |
/api/v1/costco/prices | Prix en ligne et en rayon dans jusqu'à 10 entrepôts | 1 (2 pour 10 entrepôts) |
/api/v1/costco/availability | État du stock par entrepôt | 1 par tranche de 5 entrepôts |
/api/v1/costco/warehouses | Entrepôts près de coordonnées, avec heures et essence | 2 |
/api/v1/costco/gas | Prix de l'essence par emplacement ou par entrepôt | 2 par emplacement; 2 par entrepôt |
/api/v1/costco/deals | Fils d'aubaines | 1 |
/api/v1/costco/clearance | Articles à code de liquidation dans un entrepôt | 1 par analyse |
/api/v1/costco/autocomplete | Suggestions de recherche | 1 |
Le carnet de coupons des membres et les avis ne sont offerts que pour costco.com.
Combien ça coûte
Au forfait Growth facturé annuellement (2 $ US par 1 000 crédits), un appel à 1 crédit coûte environ 0,002 $ US. Suivre 100 articles dans 9 entrepôts chaque jour, c'est 5 appels prices et 5 crédits par jour. Les 50 crédits gratuits de l'inscription couvrent 50 appels à 1 crédit. Essayez l'API Costco Canada gratuitement ou consultez les tarifs.
La page de l'API Costco Canada propose un essai en direct sans inscription, et la documentation détaille les prix en entrepôt, la disponibilité, l'essence et les liquidations. Pour comparer les fournisseurs, lisez les meilleures API Costco Canada. La même clé couvre l'API Walmart Canada et l'API Canadian Tire.
Frequently asked questions
Comment savoir le prix de l'essence Costco aujourd'hui?
Envoyez une latitude, une longitude et "country": "ca" à l'endpoint gas de l'API Costco Canada de Scavio : il renvoie le prix de l'ordinaire, du super et du diesel aux postes Costco les plus proches, avec l'adresse et les heures. Le 2 novembre 2026, l'ordinaire était à 1,779 $ le litre aux postes Bouvier, Sainte-Foy et Lévis.
Que veut dire un prix Costco qui se termine par .97?
Chez les membres, un prix en rayon qui finit par .97 signale une liquidation, et .00 ou .88 une démarque du gérant. Costco ne publie pas ces codes, il faut donc les lire comme un indice. L'endpoint clearance analyse une recherche dans un entrepôt et ne garde que ces articles : à Montréal, un réfrigérateur Café affiché 6 694,99 $ en ligne était à 1 499,97 $ en rayon.
L'API donne-t-elle le nombre d'unités en stock?
Non. Costco affiche un état, pas une quantité : l'endpoint availability renvoie in_stock, low_stock, out_of_stock ou not_available pour chaque entrepôt, plus l'état de la livraison le jour même.
Les noms de produits sont-ils en français?
Non. costco.ca publie les noms en anglais et l'API les renvoie tels quels, par exemple "Kirkland Signature Dark Colombian Ground Coffee, 1.36 kg". Vous pouvez quand même chercher en français : « café » a renvoyé 36 résultats.