API Walmart

L'API Walmart vous permet de rechercher des produits et d'obtenir des informations détaillées sur un produit par son identifiant. Les deux points d'accès prennent en charge l'émulation d'appareil, la localisation de livraison et les filtres de traitement des commandes.

Points d'accès

Point d'accès	Description
`POST /api/v1/walmart/search`	Rechercher des produits Walmart avec tri, pagination, filtres de prix et de traitement
`POST /api/v1/walmart/product`	Obtenir des informations détaillées sur un produit par son identifiant Walmart

Authentification

En-tête	Valeur	Requis
`Authorization`	`Bearer YOUR_API_KEY`	Oui
`Content-Type`	`application/json`	Oui

Recherche de produits

Bash

POST https://api.scavio.dev/api/v1/walmart/search

Recherchez des produits Walmart et obtenez des résultats structurés incluant le prix, les évaluations et la disponibilité.

Corps de la requête

Paramètre	Type	Défaut	Description
`query`	`string`	--	Requis. Requête de recherche (1 à 500 caractères).
`domain`	`string`	`""`	Domaine Walmart.
`device`	`string`	`desktop`	Type d'appareil. Un parmi : `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	Ordre de tri. Un parmi : `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	Numéro de page de départ (indexé à partir de 1).
`min_price`	`integer`	--	Filtre de prix minimum (en dollars).
`max_price`	`integer`	--	Filtre de prix maximum (en dollars).
`fulfillment_speed`	`string`	--	Filtre de vitesse de livraison. Un parmi : `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	Filtre de type de traitement. Actuellement prend en charge : `in_store`
`delivery_zip`	`string`	--	Code postal de livraison pour des résultats et une disponibilité localisés.
`store_id`	`string`	--	Identifiant du magasin Walmart pour la disponibilité en magasin.

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/walmart/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "best_seller",
    "min_price": 20,
    "max_price": 100
  }'

Exemple de réponse

JSON

{
  "data": {
    "page": 1,
    "products_count": 40,
    "location": {
      "city": "Jacksonville",
      "state": "FL",
      "store_id": "5054",
      "zipcode": "32246"
    },
    "products": [
      {
        "id": "123456789",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/ip/Sony-WH-1000XM5/123456789",
        "image": "https://i5.walmartimages.com/...",
        "price": 248.0,
        "price_strikethrough": null,
        "currency": "USD",
        "rating": 4.7,
        "rating_count": 8230,
        "sponsored": false,
        "out_of_stock": false,
        "seller_name": "Walmart.com",
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "fulfillment": {
          "delivery": true,
          "free_shipping": true,
          "pickup": true,
          "shipping": true
        },
        "pos": 1,
        "variants": []
      }
    ],
    "url": "https://www.walmart.com/search?q=...",
    "html": "",
    "screenshot": ""
  },
  "response_time": 1920,
  "credits_used": 1,
  "credits_remaining": 999
}

Détails du produit

Bash

POST https://api.scavio.dev/api/v1/walmart/product

Obtenez des informations détaillées pour un produit Walmart spécifique via son identifiant. Retourne le prix, la description, les spécifications, les images, les évaluations et les informations sur le vendeur.

Corps de la requête

Paramètre	Type	Défaut	Description
`product_id`	`string`	--	Requis. Identifiant du produit Walmart (par ex. `123456789`).
`domain`	`string`	--	Domaine Walmart.
`device`	`string`	`desktop`	Type d'appareil. Un parmi : `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	Code postal de livraison pour un prix localisé.
`store_id`	`string`	--	Identifiant du magasin Walmart pour la disponibilité en magasin.

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/walmart/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"product_id": "123456789"}'

Exemple de réponse

JSON

{
  "data": {
    "id": "123456789",
    "sku": "123456789",
    "gtin": "012345678901",
    "price": 248.0,
    "price_strikethrough": 349.99,
    "currency": "USD",
    "rating": 4.7,
    "rating_count": 8230,
    "out_of_stock": false,
    "seller_name": "Walmart.com",
    "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
    "seller_url": null,
    "image": "https://i5.walmartimages.com/...",
    "images": [
      "https://i5.walmartimages.com/..."
    ],
    "fulfillment": {
      "delivery": true,
      "delivery_information": "Arrives today",
      "free_shipping": true,
      "fulfilled_by": "",
      "out_of_stock": false,
      "pickup": true,
      "pickup_information": "Pickup today",
      "shipping": true,
      "shipping_information": "Free shipping"
    },
    "specifications": [
      { "key": "Brand", "value": "Sony" },
      { "key": "Wireless technology", "value": "Bluetooth" }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2310,
  "credits_used": 1,
  "credits_remaining": 998
}

Format de réponse

Les deux points d'accès retournent un enveloppe de réponse cohérente :

Champ	Type	Description
`data`	`object \| null`	Le contenu de la réponse. `null` si la requête a échoué en amont. La recherche retourne `{page, products, location, ...}` ; le produit retourne directement l'objet produit.
`response_time`	`number`	Temps de réponse côté serveur en millisecondes
`credits_used`	`number`	Nombre de crédits consommés
`credits_remaining`	`number`	Crédits restants dans votre période de facturation actuelle

Réponses d'erreur

Statut	Description
`401`	Non autorisé -- clé API manquante ou invalide
`429`	Limite de débit ou d'utilisation dépassée pour votre forfait
`502`	Erreur en amont -- réessayer après un court délai
`503`	Service en amont indisponible -- réessayer plus tard

Voir Erreurs pour la référence complète des erreurs et les bonnes pratiques de réessai.

Liens connexes

Démarrage rapide -- obtenez votre clé API et effectuez votre première requête
API Google Search -- recherchez sur Google avec des données SERP structurées
API YouTube -- recherchez des vidéos et extrayez des métadonnées
API Amazon -- recherchez des produits Amazon sur 12 places de marché
Limites de débit -- limites par niveau de forfait

API Walmart

Points d'accès

Point d'accès	Description
`POST /api/v1/walmart/search`	Rechercher des produits Walmart avec tri, pagination, filtres de prix et de traitement
`POST /api/v1/walmart/product`	Obtenir des informations détaillées sur un produit par son identifiant Walmart

Authentification

En-tête	Valeur	Requis
`Authorization`	`Bearer YOUR_API_KEY`	Oui
`Content-Type`	`application/json`	Oui

Recherche de produits

Bash

POST https://api.scavio.dev/api/v1/walmart/search

Recherchez des produits Walmart et obtenez des résultats structurés incluant le prix, les évaluations et la disponibilité.

Corps de la requête

Paramètre	Type	Défaut	Description
`query`	`string`	--	Requis. Requête de recherche (1 à 500 caractères).
`domain`	`string`	`""`	Domaine Walmart.
`device`	`string`	`desktop`	Type d'appareil. Un parmi : `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	Ordre de tri. Un parmi : `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	Numéro de page de départ (indexé à partir de 1).
`min_price`	`integer`	--	Filtre de prix minimum (en dollars).
`max_price`	`integer`	--	Filtre de prix maximum (en dollars).
`fulfillment_speed`	`string`	--	Filtre de vitesse de livraison. Un parmi : `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	Filtre de type de traitement. Actuellement prend en charge : `in_store`
`delivery_zip`	`string`	--	Code postal de livraison pour des résultats et une disponibilité localisés.
`store_id`	`string`	--	Identifiant du magasin Walmart pour la disponibilité en magasin.

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/walmart/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "best_seller",
    "min_price": 20,
    "max_price": 100
  }'

Exemple de réponse

JSON

{
  "data": {
    "page": 1,
    "products_count": 40,
    "location": {
      "city": "Jacksonville",
      "state": "FL",
      "store_id": "5054",
      "zipcode": "32246"
    },
    "products": [
      {
        "id": "123456789",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/ip/Sony-WH-1000XM5/123456789",
        "image": "https://i5.walmartimages.com/...",
        "price": 248.0,
        "price_strikethrough": null,
        "currency": "USD",
        "rating": 4.7,
        "rating_count": 8230,
        "sponsored": false,
        "out_of_stock": false,
        "seller_name": "Walmart.com",
        "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
        "fulfillment": {
          "delivery": true,
          "free_shipping": true,
          "pickup": true,
          "shipping": true
        },
        "pos": 1,
        "variants": []
      }
    ],
    "url": "https://www.walmart.com/search?q=...",
    "html": "",
    "screenshot": ""
  },
  "response_time": 1920,
  "credits_used": 1,
  "credits_remaining": 999
}

Détails du produit

Bash

POST https://api.scavio.dev/api/v1/walmart/product

Corps de la requête

Paramètre	Type	Défaut	Description
`product_id`	`string`	--	Requis. Identifiant du produit Walmart (par ex. `123456789`).
`domain`	`string`	--	Domaine Walmart.
`device`	`string`	`desktop`	Type d'appareil. Un parmi : `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	Code postal de livraison pour un prix localisé.
`store_id`	`string`	--	Identifiant du magasin Walmart pour la disponibilité en magasin.

Exemple

curl -X POST 'https://api.scavio.dev/api/v1/walmart/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"product_id": "123456789"}'

Exemple de réponse

JSON

{
  "data": {
    "id": "123456789",
    "sku": "123456789",
    "gtin": "012345678901",
    "price": 248.0,
    "price_strikethrough": 349.99,
    "currency": "USD",
    "rating": 4.7,
    "rating_count": 8230,
    "out_of_stock": false,
    "seller_name": "Walmart.com",
    "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
    "seller_url": null,
    "image": "https://i5.walmartimages.com/...",
    "images": [
      "https://i5.walmartimages.com/..."
    ],
    "fulfillment": {
      "delivery": true,
      "delivery_information": "Arrives today",
      "free_shipping": true,
      "fulfilled_by": "",
      "out_of_stock": false,
      "pickup": true,
      "pickup_information": "Pickup today",
      "shipping": true,
      "shipping_information": "Free shipping"
    },
    "specifications": [
      { "key": "Brand", "value": "Sony" },
      { "key": "Wireless technology", "value": "Bluetooth" }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2310,
  "credits_used": 1,
  "credits_remaining": 998
}

Format de réponse

Les deux points d'accès retournent un enveloppe de réponse cohérente :

Champ	Type	Description
`data`	`object \| null`	Le contenu de la réponse. `null` si la requête a échoué en amont. La recherche retourne `{page, products, location, ...}` ; le produit retourne directement l'objet produit.
`response_time`	`number`	Temps de réponse côté serveur en millisecondes
`credits_used`	`number`	Nombre de crédits consommés
`credits_remaining`	`number`	Crédits restants dans votre période de facturation actuelle

Réponses d'erreur

Statut	Description
`401`	Non autorisé -- clé API manquante ou invalide
`429`	Limite de débit ou d'utilisation dépassée pour votre forfait
`502`	Erreur en amont -- réessayer après un court délai
`503`	Service en amont indisponible -- réessayer plus tard

Voir Erreurs pour la référence complète des erreurs et les bonnes pratiques de réessai.

Liens connexes

Démarrage rapide -- obtenez votre clé API et effectuez votre première requête
API Google Search -- recherchez sur Google avec des données SERP structurées
API YouTube -- recherchez des vidéos et extrayez des métadonnées
API Amazon -- recherchez des produits Amazon sur 12 places de marché
Limites de débit -- limites par niveau de forfait