Walmart
API de recherche Walmart
Recherchez sur Walmart et obtenez des lignes de produits structurées en JSON : titre, identifiant d'article, prix, devise, note, nombre d'évaluations, vendeur, indicateur de commandite, disponibilité et options de livraison par article, ainsi que le magasin dont les prix sont tirés. Passez store_id et delivery_zip pour obtenir l'assortiment et la disponibilité d'un magasin précis sur walmart.com ou walmart.ca. Coûte 1 crédit sur le domaine com ou ca, 2 sur com.mx et 2 pour toute recherche ciblant un magasin : le prix dépend du corps de la requête, il n'est pas fixe pour la route.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonquerystringrequiredRequête de recherche de produits, de 1 à 500 caractères.
Example: wireless headphones
domainenum<string>default:comMarché où chercher. C'est le paramètre qui détermine le prix : com et ca coûtent 1 crédit, com.mx en coûte 2. Il fixe aussi la devise et les URL de produits de la réponse.
com— walmart.com (États-Unis). 1 crédit.ca— walmart.ca (Canada). 1 crédit.com.mx— walmart.com.mx (Mexique). 2 crédits.
pageintegerPage de résultats, à partir de 1. Une page par appel. La réponse indique max_page : paginez en vous fiant à cette valeur. has_more_pages est transmis tel quel par Walmart et peut valoir false ou null alors que d'autres pages existent.
Example: 2
start_pageintegerAlias obsolète de page, conservé pour les anciennes intégrations. Envoyez plutôt page.
sort_byenum<string>default:best_matchOrdre de tri des résultats.
best_match— Classement par pertinence de Walmart (par défaut).price_low— Prix, du plus bas au plus élevé.price_high— Prix, du plus élevé au plus bas.best_seller— Meilleurs vendeurs en premier.rating_high— Meilleures notes des clients en premier.new— Nouveautés en premier.
min_pricenumberFiltre de prix minimum, dans la devise du marché. Les décimales sont acceptées.
Example: 19.99
max_pricenumberFiltre de prix maximum, dans la devise du marché. Les décimales sont acceptées.
Example: 199.5
fulfillment_speedenum<string>Filtre de délai de livraison. Il n'existe pas de valeur 2_days (le filtre de Walmart y mêle des articles livrés en 3 ou 4 jours) ni de valeur anytime : pour n'importe quel délai, omettez le paramètre.
today— Livrable aujourd'hui.tomorrow— Livrable d'ici demain.
fulfillment_typeenum<string>Filtre de mode de réception. in_store est la seule valeur acceptée : shipping, pickup et delivery ne sont pas des options ici; lisez plutôt l'objet fulfillment de chaque article dans la réponse.
in_store— Uniquement les articles offerts pour la cueillette en magasin.
store_idstringMagasin Walmart à interroger, obtenu avec l'endpoint Walmart Stores sur le même domaine. Doit être envoyé avec delivery_zip. Pris en charge sur les domaines com et ca. Une recherche ciblant un magasin coûte 2 crédits et prend de 10 à 60 secondes. Le magasin utilisé est renvoyé dans data.location.
Example: 1389
delivery_zipstringCode postal de l'acheteur : un code ZIP américain à 5 chiffres, ou un code postal canadien comme M5V 2T6 avec le domaine ca. Obligatoire avec store_id; c'est store_id qui détermine le magasin dont vous obtenez les résultats.
Example: 50036
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
results = client.walmart.search("wireless headphones", page=1, sort_by="price_low")
print(results)
# Assortiment d'un magasin : store_id provient de client.walmart.stores("50036")
store_results = client.walmart.search("whole milk", delivery_zip="50036", store_id="1389")
print(store_results["data"]["location"])Response