Walmart Search

https://api.sandbase.ai/v1/api/walmart/search

Search Walmart products by keyword with price, rating, reviews, seller and fulfillment badges, plus sorting, price filters and pagination.

Price
$0.01USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
Async JSON
Parameters
1 required · 14 optional
Production route

Try the model

Playground

Open playground
Input
Value is used to get the items on a specific page. (e.g., `1` (default) is the first page of results, `2` is the 2nd page of results, `3` is the 3rd page of results, etc.). Maximum `page` value is `100`.
Sorting. (e.g. `price_low`, `price_high`, `best_seller`, `best_match`, `rating_high`, `new`). **Note:** `best_seller`, `rating_high`, and `new` are not supported for `walmart.com.mx`.
Items filtering based on their attributes. The structure is a list of `key:value` pairs separated by `||`. The key and value are separated by `:`
Show results with NextDay delivery only. Set to `true` to enable or `false` (default) to disable. **Note:** not supported for `walmart.com.mx`.
The search query. You can use anything that you would use in a regular Walmart search. Either a `query` or a `cat_id` parameter is required.
Category on Walmart Search. (e.g. `0` (default) is all departments, `976759_976787` is 'Cookies', etc.). Either a `query` or a `cat_id` parameter is required. **Note:** not supported for `walmart.com.mx`.
The device to use to get the results. It can be set to `desktop` (default) to use a regular browser, `tablet` to use a tablet browser (currently using iPads), or `mobile` to use a mobile browser.
Activate spelling fix. `true` (default) includes spelling fix, `false` searches without spelling fix.
Store ID to filter the products by the specific store only. Head to the Walmart Stores Locations for a full list of supported stores. It's possible for the product pricing to differ between stores.
Upper bound of price range query.
Lower bound of price range query.
Enables sort by relevance. Walmart is by default showing results sorted by relevance and using the `sort` option. Set to `false` to disable sort by Relevance. **Note:** not supported for `walmart.com.mx`.
The Walmart domain to use. It defaults to `walmart.com`. Head to the Walmart Stores for a full list of supported stores per domain.
Include `filters` to the JSON response. Set to `true` to enable or `false` to disable (default).
The fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.01 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
async

Parameters

query
string | number | boolean · required
page
string | number | boolean · optional
sort
string | number | boolean · optional
facet
string | number | boolean · optional
nd_en
any · optional
cat_id
string | number | boolean · optional
device
string | number | boolean · optional
spelling
any · optional
store_id
string | number | boolean · optional
max_price
string | number | boolean · optional
min_price
string | number | boolean · optional
soft_sort
string | number | boolean · optional
More
+3 optional parameters

Access

Provider
Walmart
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/walmart/search
Authentication
Bearer API key

API README

Walmart Search

Search Walmart products by keyword with price, rating, reviews, seller and fulfillment badges, plus sorting, price filters and pagination.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "walmart/search", "query": "laptop"}'

This API runs asynchronously. /v1/run returns a task id with status pending; poll GET https://api.sandbase.ai/v1/run/{id} until status is completed and read the result from outputs[0].data.

Parameters

NameTypeRequiredDescription
querystring/number/booleanYesThe search query. You can use anything that you would use in a regular Walmart search. Either a query or a cat_id parameter is required.
cat_idstring/number/booleanNoCategory on Walmart Search. (e.g. 0 (default) is all departments, 976759_976787 is 'Cookies', etc.). Either a query or a cat_id parameter is required. Note: not supported for `walmart.com.…
devicestring/number/booleanNoThe device to use to get the results. It can be set to desktop (default) to use a regular browser, tablet to use a tablet browser (currently using iPads), or mobile to use a mobile browser.
facetstring/number/booleanNoItems filtering based on their attributes. The structure is a list of key:value pairs separated by ||. The key and value are separated by :
include_filtersanyNoInclude filters to the JSON response. Set to true to enable or false to disable (default).
json_restrictorstring/number/booleanNoThe fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
max_pricestring/number/booleanNoUpper bound of price range query.
min_pricestring/number/booleanNoLower bound of price range query.
nd_enanyNoShow results with NextDay delivery only. Set to true to enable or false (default) to disable. Note: not supported for walmart.com.mx.
pagestring/number/booleanNoValue is used to get the items on a specific page. (e.g., 1 (default) is the first page of results, 2 is the 2nd page of results, 3 is the 3rd page of results, etc.). Maximum page value is `10…
soft_sortstring/number/booleanNoEnables sort by relevance. Walmart is by default showing results sorted by relevance and using the sort option. Set to false to disable sort by Relevance. Note: not supported for `walmart.com.…
sortstring/number/booleanNoSorting. (e.g. price_low, price_high, best_seller, best_match, rating_high, new). Note: best_seller, rating_high, and new are not supported for walmart.com.mx.
spellinganyNoActivate spelling fix. true (default) includes spelling fix, false searches without spelling fix.
store_idstring/number/booleanNoStore ID to filter the products by the specific store only. Head to the Walmart Stores Locations for a full list of supported stores. It's possible for the product pricing to differ between stores.
walmart_domainstring/number/booleanNoThe Walmart domain to use. It defaults to walmart.com. Head to the Walmart Stores for a full list of supported stores per domain.

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/walmart/search
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/walmart/search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "query": "laptop"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Walmart$0.01 per callAsync JSONOct 28, 2026
Walmart$0.01 per callAsync JSONOct 28, 2026
Walmart$0.01 per callAsync JSONOct 28, 2026

Questions

FAQ

How do I use the Walmart Search API?

Send a POST request to https://api.sandbase.ai/v1/api/walmart/search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Walmart Search API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Walmart Search API accept?

Required: query (string | number | boolean). Optional: page (string | number | boolean), sort (string | number | boolean), facet (string | number | boolean), nd_en (any), cat_id (string | number | boolean) and device (string | number | boolean) and 8 more. The Parameters table and the Playground on this page list every field.

What does the Walmart Search API return?

A JSON result. This endpoint runs asynchronously, so the response tells you how to fetch the finished result.

Do I need a Walmart developer account or API key?

No. Walmart Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Walmart API access separately.