Walmart Seller API
Our Walmart Seller API allows you to scrape a Walmart seller's details and products. Products can be sorted, filtered, and paginated.
The catalog_seller_id is the number after /seller/ in the seller page link, e.g., 101025813 in https://www.walmart.com/seller/101025813. To get all the sellers of one product instead, use our Walmart Product Sellers API.
The API endpoint is https://serpapi.com/search?engine=walmart_seller
Head to the playground for a live and interactive demo.
API parameters
Search query
catalog_seller_id
Required
Parameter defines the Walmart seller to get results for. It's the number after /seller/ in the seller page link (e.g., 101025813 in https://www.walmart.com/seller/101025813), and the catalog_seller_id in our Walmart Search API, Walmart Product API, and Walmart Product Sellers API results, not their seller_id.
Pagination
page
Optional
Parameter defines the page number. Walmart returns up to 40 products per 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, while the pagination and serpapi_pagination links stop at page 25, like Walmart's. Use sort and facet to reach more of a large seller's products.
SerpApi parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Walmart Seller results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
output
Optional
Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a Markdown-formatted version optimized for LLMs and AI agents.
json_restrictor
Optional
Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
API results
JSON results
JSON output includes structured data for seller details and the seller's products.
A search status is accessible through search_metadata.status.
It flows this way: Processing -> Success || Error.
If a search has failed, error will contain an error message.
search_metadata.id is the search ID inside SerpApi.
HTML results
This API does not have a full HTML response, only text.
search_metadata.prettify_html_file contains a link to the prettified version of the result.
It is displayed in the playground.
Markdown results
Markdown output is optimized for LLMs and AI agents. It provides a curated view of the JSON results
in a token-efficient format using tables, markdown links, and YAML frontmatter.
To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.
API examples
Example results for catalog_seller_id: 101025813
{
...
"search_information": {
"total_results": 131,
"location": {
"postal_code": "30213",
"province_code": "GA",
"city": "Fairburn",
"store_id": "855"
}
},
"seller_results": {
"seller_id": "8FA7B1DC7720487DAD179B0A88D568E7",
"catalog_seller_id": 101025813,
"name": "Hallmark",
"business_name": "Hallmark Marketing Company, LLC",
"status": "ACTIVE",
"rating": 4.7,
"reviews": 1310,
"reviews_with_text": 164,
"pro_seller": false,
"description": "Hallmark believes that when you care enough, you can change the world. That's why we are dedicated to creating a more emotionally connected world and making a difference in the lives of others.",
"address": "PO BOX 73642, CHICAGO, IL 60290, US",
"phone": "(+1) 8778591024",
"link": "https://www.walmart.com/seller/101025813"
},
"organic_results": [
{
"us_item_id": "326378759",
"product_id": "4I4DNCR8XR9C",
"title": "Hallmark Grinch Wrapping Paper (3 Rolls: 105 Sq. Ft. Ttl) for Christmas with Blue Tiles, White Snowflakes, Cindy Lou Who, Max",
"thumbnail": "https://i5.walmartimages.com/seo/Hallmark-Grinch-Wrapping-Paper-3-Rolls-105-Sq-Ft-Ttl-for-Christmas-with-Blue-Tiles-White-Snowflakes-Cindy-Lou-Who-Max_cfef2bbe-ae1a-4cdb-b3ab-1b4faa8b0a66.096bea293fd92bd6272be30bdacd5d8a.jpeg",
"rating": 4.7,
"reviews": 69,
"seller_id": "8FA7B1DC7720487DAD179B0A88D568E7",
"catalog_seller_id": 101025813,
"seller_name": "Hallmark",
"serpapi_seller_link": "https://serpapi.com/search.json?catalog_seller_id=101025813&engine=walmart_seller",
...
"shipping_price": 1.0,
"out_of_stock": false,
"sponsored": false,
"multiple_options_available": false,
"primary_offer": {
"offer_id": "F1372ED78F6B3F4CB7BCBB8E4478DF75",
"offer_price": 16.98
},
"price_per_unit": {
"unit": "each"
},
"product_type": "Gift Wrap Paper",
"product_page_url": "https://www.walmart.com/ip/Hallmark-Grinch-Wrapping-Paper-3-Rolls-105-Sq-Ft-Ttl-for-Christmas-with-Blue-Tiles-White-Snowflakes-Cindy-Lou-Who-Max/326378759?classType=REGULAR&selectedSellerId=101025813",
"serpapi_product_page_url": "https://serpapi.com/search.json?device=desktop&engine=walmart_product&product_id=326378759"
},
...
],
"pagination": {
"current": 1,
"next": "https://www.walmart.com/seller/101025813/cp/shopall?page=2",
"other_pages": {
"2": "https://www.walmart.com/seller/101025813/cp/shopall?page=2",
"3": "https://www.walmart.com/seller/101025813/cp/shopall?page=3",
"4": "https://www.walmart.com/seller/101025813/cp/shopall?page=4"
}
},
"serpapi_pagination": {
"current": 1,
"next": "https://serpapi.com/search.json?catalog_seller_id=101025813&engine=walmart_seller&page=2",
"other_pages": {
"2": "https://serpapi.com/search.json?catalog_seller_id=101025813&engine=walmart_seller&page=2",
"3": "https://serpapi.com/search.json?catalog_seller_id=101025813&engine=walmart_seller&page=3",
"4": "https://serpapi.com/search.json?catalog_seller_id=101025813&engine=walmart_seller&page=4"
}
}
}
Example results with sort, facet, and page
Products sold by 6AVE Electronics, filtered by the Canon brand with facet: brand:Canon, sorted from the lowest price with sort: price_low, on the second page with page: 2.
{
...
"search_information": {
"total_results": 1308,
...
},
...
"organic_results": [
{
"us_item_id": "15394624228",
"product_id": "78ISQ3K49K0X",
"title": "Canon PowerShot PICK PTZ Camera (White) (4825C001) + 64GB Memory Card + Flexible Tripod + USB-C Cable + Cleaning Kit + Card Wallet + Card Reader (International Version)",
"thumbnail": "https://i5.walmartimages.com/seo/Canon-PowerShot-PICK-PTZ-Camera-White-4825C001-64GB-Memory-Card-Flexible-Tripod-USB-C-Cable-Cleaning-Kit-Card-Wallet-Card-Reader_9d059c82-771f-477a-b9fd-03c9643812b4.477a793002411058cb980e8d5ef91266.jpeg",
"rating": 0,
"reviews": 0,
"seller_id": "F4AD07D5DBE0499E811C7AD75990860B",
"catalog_seller_id": 4720,
"seller_name": "6AVE Electronics",
"serpapi_seller_link": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller",
...
"out_of_stock": false,
"sponsored": false,
"multiple_options_available": false,
"primary_offer": {
"offer_id": "98327C718C0B3B47A2E470BC84A73147",
"offer_price": 229.95
},
"price_per_unit": {
"unit": "each"
},
"product_type": "Digital Cameras",
"product_page_url": "https://www.walmart.com/ip/Canon-PowerShot-PICK-PTZ-Camera-White-4825C001-64GB-Memory-Card-Flexible-Tripod-USB-C-Cable-Cleaning-Kit-Card-Wallet-Card-Reader/15394624228?classType=REGULAR&selectedSellerId=4720",
"serpapi_product_page_url": "https://serpapi.com/search.json?device=desktop&engine=walmart_product&product_id=15394624228"
},
{
"us_item_id": "18982067371",
"product_id": "4LQ1WYFWYSWG",
...
"primary_offer": {
"offer_id": "A37A281BC76F342D92EB84403B55A874",
"offer_price": 235.49
},
...
},
...
],
...
"serpapi_pagination": {
"current": 2,
"previous": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=brand%3ACanon&page=1&sort=price_low",
"next": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=brand%3ACanon&page=3&sort=price_low",
"other_pages": {
"1": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=brand%3ACanon&page=1&sort=price_low",
"3": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=brand%3ACanon&page=3&sort=price_low",
"4": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=brand%3ACanon&page=4&sort=price_low",
...
}
}
}
JSON structure overview
{
...
"search_information": {
"total_results": "Integer - Number of the seller's products, or of those matching facet when set. Not included when there are no products",
"location": {
"postal_code": "String - Postal code of the location used for prices and shipping",
"province_code": "String - State or province code of the location",
"city": "String - City of the location",
"store_id": "String - Walmart store ID of the location"
},
"organic_results_state": "String - 'Fully empty' when there are no products: the seller has none, nothing matches facet, or the seller doesn't exist"
},
"seller_results": {
"seller_id": "String - Walmart's internal seller ID, the same as in organic_results and our other Walmart APIs",
"catalog_seller_id": "Integer - Seller ID in the seller page link, as used by the catalog_seller_id parameter",
"name": "String - Seller name",
"business_name": "String - Business name of the seller",
"status": "String - Seller account status (e.g. 'ACTIVE', 'SUSPENDED', 'TERMINATED')",
"rating": "Float - Average seller rating, out of 5. Not included when the seller has no ratings",
"reviews": "Integer - Number of seller ratings",
"reviews_with_text": "Integer - Number of seller ratings with a written review",
"pro_seller": "Boolean - Whether the seller has the Pro Seller badge",
"description": "String - About the seller",
"address": "String - Seller address. Not included when the seller is exempted from showing it, e.g., for a home address, or is terminated",
"phone": "String - Seller phone number. Not included when the seller is exempted from showing it, or is terminated",
"logo": "String - Link to the seller logo",
"banner": "String - Link to the seller banner",
"link": "String - Link to the seller page"
},
"error": "String - 'Walmart hasn't returned any results for this seller.' when there are no products, or 'Walmart couldn't find this seller.' for an unknown catalog_seller_id",
"organic_results": [
{
// Same structure as the organic results of our Walmart Search API: https://serpapi.com/walmart-organic-results
"us_item_id": "String - Walmart US item ID",
"product_id": "String - Unique product identifier",
"title": "String - Title of the product",
"description": "String - Short description of the product",
"thumbnail": "String - URL to product image",
"rating": "Float - Average product rating",
"reviews": "Integer - Total number of reviews",
"seller_id": "String - Walmart's internal seller ID, the same as seller_results.seller_id",
"catalog_seller_id": "Integer - Seller ID in the seller page link, the same as seller_results.catalog_seller_id",
"seller_name": "String - Display name of the seller",
"serpapi_seller_link": "String - SerpApi link to the seller's page and products with our Walmart Seller API",
"primary_offer": {
"offer_id": "String - Unique offer identifier",
"offer_price": "Float - Offer price",
"min_price": "Float - Minimum offer price",
"was_price": "Float - Original price before discount"
},
"product_page_url": "String - URL to the Walmart product page",
"serpapi_product_page_url": "String - SerpApi link to fetch product details",
...
},
...
],
// With include_filters set to true, when there are products
"filters": [
{
"name": "String - Filter name (e.g. 'Brand')",
"type": "String - Filter key, as used in the facet parameter (e.g. 'brand')",
"values": [
{
"id": "String - Filter value, as used in the facet parameter (e.g. 'Canon')",
"name": "String - Filter value name",
"selected": "Boolean - Present and true when the filter value is applied",
"url": "String - Link to the seller's products with the filter value applied, or removed when selected",
"serpapi_url": "String - SerpApi link to the seller's products with the filter value applied, or removed when selected"
},
...
]
},
...
],
"pagination": {
"current": "Integer - Current page number",
"next": "String - Link to the next page of the seller's products, up to page 25",
"previous": "String - Link to the previous page of the seller's products",
"other_pages": {
"Integer": "String - Link to the given page of the seller's products, up to page 25"
}
},
"serpapi_pagination": {
"current": "Integer - Current page number",
"next": "String - SerpApi link to the next page",
"previous": "String - SerpApi link to the previous page",
"other_pages": {
"Integer": "String - SerpApi link to the given page"
}
}
}