Walmart Search API
Walmart Search API uses /api/v1/search?engine=walmart_search
API endpoint to scrape real-time results.
The Walmart Search API provides developers with access to Walmart's extensive product database. You can search for products, filter by various criteria, and retrieve detailed product information including pricing, reviews, and availability. This API is perfect for price comparison tools, market analysis, and e-commerce applications.
API Parameters
Search Query
-
- Name
-
q
- Required
- Required
- Description
-
The parameter specifies your search query. It accepts any term or phrase you'd typically input in a Walmart search.
Filters
-
- Name
-
category_id
- Required
- Optional
- Description
-
This parameter filters search to a specific category id. You can find the list of categories and its ids in the
filters
section of the response.
Another way is to search on Walmart and add a filter by department, for example: searching for "Bear" and selecting "Food" in Departments gives ushttps://www.walmart.com/search?q=bear&catId=976759
where976759
is the category ID for "Food". If you also select a sub-category, Walmart links the IDs with an underscore in between, in the same search example we can also select "Candy" as subcategory, giving ushttps://www.walmart.com/search?q=bear&catId=976759_1096070
where976759_1096070
is the category id for both "Food" and its sub-category "Candy".
-
- Name
-
store_id
- Required
- Optional
- Description
-
This parameter filters search results to a specific Walmart Store. You can check the list of stores on Walmart's stores directory. You can download a JSON file with all the store IDs here. Default value is
3081
which is the default store id for Walmart when none is provided.
-
- Name
-
price_min
- Required
- Optional
- Description
-
This parameter controls the minimum price of the products returned. For instance -
10
value would return products with a minimum price of$10
.
-
- Name
-
price_max
- Required
- Optional
- Description
-
This parameter controls the maximum price of the products returned. For instance -
20.5
value would return products with a maximum price of$20.5
.
-
- Name
-
filters
- Required
- Optional
- Description
-
To narrow search results using filters, use the format
name:value
. For multiple filters, separate them with a double pipe (||
). For example:
brand:Samsung||price:5-10
The full list of available filters appears in the response’sfilters
section. However, the quickest way to discover valid filters is to:
- Go to Walmart.com.
- Run a product search and apply the filters you want.
- Copy the value that appears in the URL after
facet=
.
https://www.walmart.com/search?query=Chocolate&facet=brand%3AHershey%27s
The part afterfacet=
is the filter string:
brand%3AHershey%27s
Use this value as the filter parameter in your API request.
Note: Some filters may contain the&
character. In such cases, make sure to escape it using&
in your request.
-
- Name
-
sort_by
- Required
- Optional
- Description
-
Parameter allows sorting search results by different criteria. Below is the list of available sorting options:
-
best_match
- sort order based on relevance. Default price_low_to_high
price_high_to_low
best_seller
-
Pagination
-
- Name
-
page
- Required
- Optional
- Description
-
The parameter determines the results page number. It defaults to
1
. You can find the max page number in the pagination section of the response.
Engine
-
- Name
-
engine
- Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
walmart_search
.
API key
-
- Name
-
api_key
- Required
- Required
- Description
-
The
api_key
authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY
) or in the Authorization header (Bearer YOUR_API_KEY
).
API Examples
Full Response

https://www.searchapi.io/api/v1/search?engine=walmart_search&q=chocolate
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "walmart_search",
"q": "chocolate"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_AEM9arelpd2kFnboW0Nw8nB5",
"status": "Success",
"created_at": "2025-06-28T19:44:00Z",
"request_time_taken": 3.02,
"parsing_time_taken": 0.17,
"total_time_taken": 3.19,
"request_url": "https://www.walmart.com/search?q=chocolate",
"html_url": "https://www.searchapi.io/api/v1/searches/search_AEM9arelpd2kFnboW0Nw8nB5.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_AEM9arelpd2kFnboW0Nw8nB5"
},
"search_parameters": {
"engine": "walmart_search",
"q": "chocolate"
},
"search_information": {
"total_results": 23955,
"time_taken": 0.807,
"postal_code": "95829",
"province_code": "CA",
"city": "Sacramento",
"store_id": "3081"
},
"organic_results": [
{
"position": 1,
"id": "10429811825",
"product_id": "1VHBPBUMQH5P",
"title": "HERSHEY'S KISSES CINNAMON TOAST CRUNCH Flavored Candy Share Pack, 9 oz",
"link": "https://www.walmart.com/ip/HERSHEY-S-KISSES-CINNAMON-TOAST-CRUNCH-Flavored-Candy-Share-Pack-9-oz/10429811825?classType=REGULAR",
"seller_id": "F55CDC31AB754BB68FE0B39041159D63",
"seller_name": "Walmart.com",
"rating": 4.5,
"reviews": 89,
"price": "$5.48",
"extracted_price": 5.48,
"unit_price": "60.9 ¢/oz",
"extracted_unit_price": 60.9,
"fulfillment": {
"pickup": {
"text": "PICKUP",
"expected_date": "2025-06-28"
}
},
"is_free_shipping_with_walmart_plus": true,
"is_subscription_eligible": true,
"is_sponsored": true,
"badges": [
{
"key": "SAVE_WITH_W_PLUS",
"text": "Save with Walmart+"
},
{
"key": "FF_DELIVERY",
"text": "Delivery as soon as 1 hour",
"group_name": "fulfillment"
},
{
"key": "FF_PICKUP",
"text": "Pickup as soon as 3pm",
"group_name": "fulfillment"
},
{
"key": "SUBSCRIPTION_ELIGIBLE",
"text": "Subscribe",
"group_name": "subscription"
},
{
"key": "SNAP_ELIGIBLE",
"text": "SNAP eligible",
"group_name": "benefits"
}
],
"thumbnail": "https://i5.walmartimages.com/seo/HERSHEY-S-KISSES-CINNAMON-TOAST-CRUNCH-Flavored-Candy-Share-Pack-9-oz_239a58e5-1034-4379-815b-d27902641491.0fe2022e4eb9c6b0f5610aca3b86ef2f.jpeg"
},
...
],
"filters": [
{
"name": "Sort by",
"type": "sort",
"values": [
{
"id": "best_match",
"name": "Best Match"
},
{
"id": "price_low",
"name": "Price Low"
},
{
"id": "price_high",
"name": "Price High"
},
{
"id": "best_seller",
"name": "Best Seller"
}
]
},
{
"name": "Price",
"type": "price",
"min_value": 0,
"max_value": 30
},
...
],
"related_searches": [
{
"query": "chocolate milk",
"link": "https://www.walmart.com/search?q=chocolate%20milk"
},
{
"query": "chocolate syrup",
"link": "https://www.walmart.com/search?q=chocolate%20syrup"
},
...
],
"pagination": {
"current": 1,
"next": "https://www.walmart.com/search?q=chocolate&page=2",
"other_pages": {
"2": "https://www.walmart.com/search?q=chocolate&page=2",
"3": "https://www.walmart.com/search?q=chocolate&page=3",
"4": "https://www.walmart.com/search?q=chocolate&page=4",
...
}
}
}
Organic Results - Electronics

https://www.searchapi.io/api/v1/search?engine=walmart_search&q=electronics
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "walmart_search",
"q": "electronics"
}
response = requests.get(url, params=params)
print(response.text)
{
...
"organic_results": [
{
"position": 1,
"id": "5871736556",
"product_id": "44P8OQI03PGX",
"title": "Meta Quest 3S 128GB – Get Batman: Arkham Shadow and a 3-Month Trial of Meta Horizon+ Included – All-In-One Headset",
"link": "https://www.walmart.com/ip/Meta-Quest-3S-128GB-Get-Batman-Arkham-Shadow-and-a-3-Month-Trial-of-Meta-Quest-Included-All-In-One-Headset/5871736556?classType=REGULAR",
"seller_id": "F55CDC31AB754BB68FE0B39041159D63",
"seller_name": "Walmart.com",
"rating": 4.6,
"reviews": 4227,
"price": "$299.00",
"extracted_price": 299.0,
"fulfillment": {
"delivery": {
"text": "DELIVERY",
"expected_date": "2025-06-29"
},
"pickup": {
"text": "PICKUP",
"expected_date": "2025-06-28"
}
},
"is_free_shipping": true,
"is_free_shipping_with_walmart_plus": true,
"is_sponsored": true,
"badges": [
{
"key": "SAVE_WITH_W_PLUS",
"text": "Save with Walmart+"
},
{
"key": "FF_DELIVERY",
"text": "Delivery as soon as 1 hour",
"group_name": "fulfillment"
},
{
"key": "FF_SHIPPING",
"text": "Free shipping, arrives tomorrow",
"group_name": "fulfillment"
},
{
"key": "FF_PICKUP",
"text": "Free pickup as soon as 3pm",
"group_name": "fulfillment"
}
],
"thumbnail": "https://i5.walmartimages.com/seo/Meta-Quest-3S-128GB-Get-Batman-Arkham-Shadow-and-a-3-Month-Trial-of-Meta-Quest-Included-All-In-One-Headset_955baa40-f337-4daf-ac38-674e747d13de.899e13d8670b21b94d6deb22c6b1635b.jpeg"
},
...
],
...
}
Other Options

https://www.searchapi.io/api/v1/search?engine=walmart_search&q=Shop+jeans
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "walmart_search",
"q": "Shop jeans"
}
response = requests.get(url, params=params)
print(response.text)
{
...
"other_options": [
{
"position": 1,
"id": "15645071981",
"product_id": "2RG4UZY8CWFS",
"title": "No Boundaries Cargo Wide-Leg Pants, 31.5'' Inseam, Women's",
"description": "No Boundaries Wide Leg Cargo Pants, 31.5'' Inseam, Women's",
"link": "https://www.walmart.com/ip/No-Boundaries-Cargo-Wide-Leg-Women-s/15645071981?classType=VARIANT",
"brand": "No Boundaries",
"seller_id": "F55CDC31AB754BB68FE0B39041159D63",
"seller_name": "Walmart.com",
"rating": 4.7,
"reviews": 2498,
"price": "$16.98",
"extracted_price": 16.98,
"price_range": {
"text": "Options from $8.87",
"from": "Options from $8.87",
"extracted_from_price": 8.87
},
"fulfillment": {
"delivery": {
"text": "DELIVERY",
"expected_date": "2025-07-03"
}
},
"variants": [
{
"id": "5323887784",
"product_id": "1U6LG8IR51L3",
"title": "Black Soot",
"link": "https://www.walmart.com/ip/No-Boundaries-Juniors-Wide-Leg-Cargo-Pants-Sizes-XXS-XXL/5323887784?classType=undefined&variantFieldId=actual_color",
"thumbnail": "https://i5.walmartimages.com/asr/b3c5d633-82ba-4b22-854f-84d71e945018.c8c66b2ca81849a96cc75b9ca1ba0276.jpeg",
"swatch_thumbnail": "https://i5.walmartimages.com/asr/d3e6e7ad-03c8-4128-ae51-7360185d71be.ed491af6250dea37c96ff094f8011301.png?odnHeight=30&odnWidth=30&odnBg=ffffff"
},
{
"id": "12398322883",
"product_id": "101T49DAF8T5",
"title": "Ecru",
"link": "https://www.walmart.com/ip/No-Boundaries-Wide-Leg-Cargo-Pants-31-5-Inseam-Women-s/12398322883?classType=undefined&variantFieldId=actual_color",
"thumbnail": "https://i5.walmartimages.com/asr/1021e468-f6bd-4866-b964-dc3241651cf9.19747293c6d323e24661bd70837743d2.jpeg",
"swatch_thumbnail": "https://i5.walmartimages.com/asr/39d585a8-5ad4-4d69-b073-87faa20a683a.cb306430f0d1b1c94da3435b735b0b0f.png?odnHeight=30&odnWidth=30&odnBg=ffffff"
},
...
],
"stock": 6,
"is_free_shipping_with_walmart_plus": true,
"badges": [
{
"key": "SAVE_WITH_W_PLUS",
"text": "Save with Walmart+"
},
{
"key": "FF_SHIPPING",
"text": "Shipping, arrives in 3+ days",
"group_name": "fulfillment"
},
{
"key": "LOW_INVENTORY",
"text": "Only 6 left",
"group_name": "urgency"
}
],
"thumbnail": "https://i5.walmartimages.com/seo/No-Boundaries-Cargo-Wide-Leg-Women-s_61bdad9b-012d-4709-b07f-8e4ec0044cea.ffff4921031241390c7bf557f7055eff.jpeg"
},
...
],
...
}
Filters

https://www.searchapi.io/api/v1/search?engine=walmart_search&q=chocolate
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "walmart_search",
"q": "chocolate"
}
response = requests.get(url, params=params)
print(response.text)
{
"filters": [
{
"name": "Departments",
"type": "cat_id",
"values": [
{
"id": "976759",
"name": "Food",
"items_count": 1550,
"type": "cat_id"
},
{
"id": "4044",
"name": "Home",
"items_count": 91,
"type": "cat_id"
}
]
},
{
"name": "Price",
"type": "price",
"min_value": 0,
"max_value": 30
},
{
"name": "Brand",
"type": "brand",
"values": [
{
"id": "Hershey's",
"name": "Hershey's",
"item_count": 220
},
{
"id": "M&M'S",
"name": "M&M'S",
"item_count": 98
},
...
]
},
...
]
}
Variants - Coffee Maker

https://www.searchapi.io/api/v1/search?engine=walmart_search&q=coffee+maker
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "walmart_search",
"q": "coffee maker"
}
response = requests.get(url, params=params)
print(response.text)
{
...
"organic_results": [
{
"position": 13,
"id": "111488395",
"product_id": "7JQ6UWQBN23T",
"title": "Keurig K-Express Essentials Single Serve K-Cup Pod Coffee Maker, Black",
"description": "36 OZ removable reservoirSPACE SAVING Dimensions out of box: 11.3 x 6.5 x 12.2.BACK-TO-BACK BREWING: Immediately brew a second cup, no need to wait for reheating.SIMPLE",
"link": "https://www.walmart.com/ip/Keurig-K-Express-Essentials-Single-Serve-K-Cup-Pod-Coffee-Maker-Black/111488395?classType=VARIANT&athbdg=L1600",
"seller_id": "A73ADA8D421A4BCEA7773442C08FDE08",
"seller_name": "Ninja Tech Squad",
"rating": 4.5,
"reviews": 59217,
"price": "$84.99",
"extracted_price": 84.99,
"price_range": {
"text": "Options from $39.97",
"from": "Options from $39.97",
"extracted_from_price": 39.97
},
"fulfillment": {
"delivery": {
"text": "DELIVERY",
"expected_date": "2025-07-08"
}
},
"variants": [
{
"id": "111488395",
"product_id": "2CSRV4LCWQFR",
"title": "Black",
"link": "https://www.walmart.com/ip/Keurig-K-Express-Essentials-Single-Serve-K-Cup-Pod-Coffee-Maker-Black/111488395?classType=undefined&variantFieldId=actual_color",
"thumbnail": "https://i5.walmartimages.com/asr/1f5cf20c-92af-4f8b-b2a6-fd273417fc49.2d0167b955af894b47a893e2b7c9e055.jpeg",
"swatch_thumbnail": "https://i5.walmartimages.com/asr/ab52dbc5-e05a-4c8f-b22e-e657609f7a23.1bc45787ae6e6d50e075d136f7888d69.png?odnHeight=30&odnWidth=30&odnBg=ffffff"
},
{
"id": "264278498",
"product_id": "2F2FRTM9LSM9",
"title": "Navy",
"link": "https://www.walmart.com/ip/Keurig-K-Express-Essentials-Single-Serve-K-Cup-Pod-Coffee-Maker-Pacific-Blue/264278498?classType=undefined&variantFieldId=actual_color",
"thumbnail": "https://i5.walmartimages.com/asr/7d6142a8-6f01-442c-b172-b887b97370b3.eff2c2d9f0c13dea239c8e1c0a31c42d.jpeg",
"swatch_thumbnail": "https://i5.walmartimages.com/asr/03aa4459-bc42-43bc-ac59-c08b2c6c11fa.a8b698f758df03c5283da15e1ae75599.png?odnHeight=30&odnWidth=30&odnBg=ffffff"
},
{
"id": "183090953",
"product_id": "77QFUCA288M8",
"title": "Red",
"link": "https://www.walmart.com/ip/Keurig-K-Express-Essentials-Single-Serve-K-Cup-Pod-Coffee-Maker-Red/183090953?classType=undefined&variantFieldId=actual_color",
"thumbnail": "https://i5.walmartimages.com/asr/c90f07a2-f344-457d-bdea-e6a1ced2c6d2.f872fd526e58f688b2cc1bb70e322ecc.jpeg",
"swatch_thumbnail": "https://i5.walmartimages.com/asr/9c2fa4cb-5381-43c0-801f-74b515b7d496.9cd47d3bcdbabc5dd9ed4be4bed29c68.png?odnHeight=30&odnWidth=30&odnBg=ffffff"
},
...
],
"flag": "Best seller",
"stock": 2,
"is_free_shipping": true,
"badges": [
{
"key": "BESTSELLER",
"text": "Best seller"
},
{
"key": "FF_SHIPPING",
"text": "Free shipping, arrives in 3+ days",
"group_name": "fulfillment"
},
{
"key": "LOW_INVENTORY",
"text": "Only 2 left",
"group_name": "urgency"
}
],
"thumbnail": "https://i5.walmartimages.com/seo/Keurig-K-Express-Essentials-Single-Serve-K-Cup-Pod-Coffee-Maker-Black_1f5cf20c-92af-4f8b-b2a6-fd273417fc49.2d0167b955af894b47a893e2b7c9e055.jpeg"
},
...
],
...
}