API Walmart

L'API Walmart ti permette di cercare prodotti e ottenere informazioni dettagliate sui prodotti tramite ID prodotto. Entrambi gli endpoint supportano l'emulazione del dispositivo, la localizzazione della consegna e i filtri di evasione.

Endpoint

Endpoint	Descrizione
`POST /api/v1/walmart/search`	Cerca prodotti Walmart con filtri di ordinamento, paginazione, prezzo e evasione
`POST /api/v1/walmart/product`	Ottieni informazioni dettagliate sul prodotto tramite ID prodotto Walmart

Autenticazione

Intestazione	Valore	Richiesto
`Authorization`	`Bearer YOUR_API_KEY`	Sì
`Content-Type`	`application/json`	Sì

Ricerca Prodotto

Bash

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

Cerca prodotti Walmart e ottieni risultati strutturati che includono prezzi, valutazioni e disponibilità.

Corpo della Richiesta

Parametro	Tipo	Default	Descrizione
`query`	`string`	--	Obbligatorio. Query di ricerca (1-500 caratteri).
`domain`	`string`	`""`	Dominio Walmart.
`device`	`string`	`desktop`	Tipo di dispositivo. Uno tra: `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	Ordine di ordinamento. Uno tra: `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	Numero di pagina iniziale (indicizzato da 1).
`min_price`	`integer`	--	Filtro prezzo minimo (in dollari).
`max_price`	`integer`	--	Filtro prezzo massimo (in dollari).
`fulfillment_speed`	`string`	--	Filtro velocità di consegna. Uno tra: `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	Filtro tipo di evasione. Attualmente supporta: `in_store`
`delivery_zip`	`string`	--	Codice ZIP di consegna per risultati e disponibilità localizzati.
`store_id`	`string`	--	ID negozio Walmart per la disponibilità in negozio.

Esempio

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
  }'

Esempio di Risposta

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
}

Dettagli Prodotto

Bash

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

Ottieni informazioni dettagliate per un prodotto Walmart specifico tramite il suo ID prodotto. Restituisce prezzo, descrizione, specifiche, immagini, valutazioni e informazioni sul venditore.

Corpo della Richiesta

Parametro	Tipo	Default	Descrizione
`product_id`	`string`	--	Obbligatorio. ID prodotto Walmart (es. `123456789`).
`domain`	`string`	--	Dominio Walmart.
`device`	`string`	`desktop`	Tipo di dispositivo. Uno tra: `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	Codice ZIP di consegna per prezzi localizzati.
`store_id`	`string`	--	ID negozio Walmart per la disponibilità in negozio.

Esempio

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"}'

Esempio di Risposta

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
}

Formato della Risposta

Entrambi gli endpoint restituiscono un wrapper di risposta coerente:

Campo	Tipo	Descrizione
`data`	`object \| null`	Il payload della risposta. `null` se la richiesta fallisce a monte. La ricerca restituisce `{page, products, location, ...}`; il prodotto restituisce l'oggetto prodotto direttamente.
`response_time`	`number`	Tempo di risposta lato server in millisecondi
`credits_used`	`number`	Numero di crediti consumati
`credits_remaining`	`number`	Crediti rimanenti nel tuo attuale periodo di fatturazione

Risposte di Errore

Stato	Descrizione
`401`	Non autorizzato -- chiave API mancante o non valida
`429`	Limite di frequenza o di utilizzo superato per il tuo piano
`502`	Errore a monte -- riprova dopo un breve ritardo
`503`	Servizio a monte non disponibile -- riprova più tardi

Consulta Errori per il riferimento completo degli errori e le migliori pratiche per i tentativi.

Correlati

Guida rapida -- ottieni la tua chiave API e fai la tua prima richiesta
API Google Search -- cerca su Google con dati SERP strutturati
API YouTube -- cerca video ed estrai metadati
API Amazon -- cerca prodotti Amazon in 12 marketplace
Limiti di Frequenza -- limiti per livello di piano

API Walmart

Endpoint

Endpoint	Descrizione
`POST /api/v1/walmart/search`	Cerca prodotti Walmart con filtri di ordinamento, paginazione, prezzo e evasione
`POST /api/v1/walmart/product`	Ottieni informazioni dettagliate sul prodotto tramite ID prodotto Walmart

Autenticazione

Intestazione	Valore	Richiesto
`Authorization`	`Bearer YOUR_API_KEY`	Sì
`Content-Type`	`application/json`	Sì

Ricerca Prodotto

Bash

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

Cerca prodotti Walmart e ottieni risultati strutturati che includono prezzi, valutazioni e disponibilità.

Corpo della Richiesta

Parametro	Tipo	Default	Descrizione
`query`	`string`	--	Obbligatorio. Query di ricerca (1-500 caratteri).
`domain`	`string`	`""`	Dominio Walmart.
`device`	`string`	`desktop`	Tipo di dispositivo. Uno tra: `desktop`, `mobile`, `tablet`
`sort_by`	`string`	`best_match`	Ordine di ordinamento. Uno tra: `best_match`, `price_low`, `price_high`, `best_seller`
`start_page`	`integer`	`1`	Numero di pagina iniziale (indicizzato da 1).
`min_price`	`integer`	--	Filtro prezzo minimo (in dollari).
`max_price`	`integer`	--	Filtro prezzo massimo (in dollari).
`fulfillment_speed`	`string`	--	Filtro velocità di consegna. Uno tra: `today`, `tomorrow`, `2_days`, `anytime`
`fulfillment_type`	`string`	--	Filtro tipo di evasione. Attualmente supporta: `in_store`
`delivery_zip`	`string`	--	Codice ZIP di consegna per risultati e disponibilità localizzati.
`store_id`	`string`	--	ID negozio Walmart per la disponibilità in negozio.

Esempio

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
  }'

Esempio di Risposta

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
}

Dettagli Prodotto

Bash

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

Ottieni informazioni dettagliate per un prodotto Walmart specifico tramite il suo ID prodotto. Restituisce prezzo, descrizione, specifiche, immagini, valutazioni e informazioni sul venditore.

Corpo della Richiesta

Parametro	Tipo	Default	Descrizione
`product_id`	`string`	--	Obbligatorio. ID prodotto Walmart (es. `123456789`).
`domain`	`string`	--	Dominio Walmart.
`device`	`string`	`desktop`	Tipo di dispositivo. Uno tra: `desktop`, `mobile`, `tablet`
`delivery_zip`	`string`	--	Codice ZIP di consegna per prezzi localizzati.
`store_id`	`string`	--	ID negozio Walmart per la disponibilità in negozio.

Esempio

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"}'

Esempio di Risposta

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
}

Formato della Risposta

Entrambi gli endpoint restituiscono un wrapper di risposta coerente:

Campo	Tipo	Descrizione
`data`	`object \| null`	Il payload della risposta. `null` se la richiesta fallisce a monte. La ricerca restituisce `{page, products, location, ...}`; il prodotto restituisce l'oggetto prodotto direttamente.
`response_time`	`number`	Tempo di risposta lato server in millisecondi
`credits_used`	`number`	Numero di crediti consumati
`credits_remaining`	`number`	Crediti rimanenti nel tuo attuale periodo di fatturazione

Risposte di Errore

Stato	Descrizione
`401`	Non autorizzato -- chiave API mancante o non valida
`429`	Limite di frequenza o di utilizzo superato per il tuo piano
`502`	Errore a monte -- riprova dopo un breve ritardo
`503`	Servizio a monte non disponibile -- riprova più tardi

Consulta Errori per il riferimento completo degli errori e le migliori pratiche per i tentativi.

Correlati

Guida rapida -- ottieni la tua chiave API e fai la tua prima richiesta
API Google Search -- cerca su Google con dati SERP strutturati
API YouTube -- cerca video ed estrai metadati
API Amazon -- cerca prodotti Amazon in 12 marketplace
Limiti di Frequenza -- limiti per livello di piano