Walmart Seller Filtering API
SerpApi's Walmart Seller Filtering API lets you narrow down a seller's products with the facet parameter, e.g., to get only black Sony products.
Set include_filters to true to get the filters available for the seller's products, with SerpApi links that apply or remove each value.
The API endpoint is https://serpapi.com/search?engine=walmart_seller
Head to the playground for a live and interactive demo.
API examples
Filters available for catalog_seller_id: 4720
{
...
"filters": [
{
"name": "Brand",
"type": "brand",
"values": [
{
"id": "Sony",
"name": "Sony",
"url": "https://www.walmart.com/seller/4720/cp/shopall?facet=brand%3ASony",
"serpapi_url": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=brand%3ASony&include_filters=true"
},
{
"id": "Canon",
"name": "Canon",
"url": "https://www.walmart.com/seller/4720/cp/shopall?facet=brand%3ACanon",
"serpapi_url": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=brand%3ACanon&include_filters=true"
},
...
]
},
{
"name": "Color",
"type": "color",
"values": [
{
"id": "Black",
"name": "Black",
"url": "https://www.walmart.com/seller/4720/cp/shopall?facet=color%3ABlack",
"serpapi_url": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=color%3ABlack&include_filters=true"
},
{
"id": "White",
"name": "White",
"url": "https://www.walmart.com/seller/4720/cp/shopall?facet=color%3AWhite",
"serpapi_url": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=color%3AWhite&include_filters=true"
},
...
]
},
{
"name": "Customer Rating",
"type": "customer_rating_range_facet_new_filter_v0",
"values": [
{
"id": "4 - 5 Stars",
"name": "4 - 5 Stars",
"url": "https://www.walmart.com/seller/4720/cp/shopall?facet=customer_rating_range_facet_new_filter_v0%3A4+-+5+Stars",
"serpapi_url": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=customer_rating_range_facet_new_filter_v0%3A4+-+5+Stars&include_filters=true"
},
...
]
},
...
],
...
}
Example results for facet: brand:Sony||color:Black
Products sold by 6AVE Electronics of the Sony brand, in Black. Values of different filters narrow down the results, while values of the same filter widen them, e.g., brand:Sony||brand:Canon returns the products of both brands.
{
...
"search_information": {
"total_results": 683,
...
},
...
"organic_results": [
{
"us_item_id": "749842061",
"product_id": "75Y4PVWTTL5X",
"title": "Sony Z-Series NP-FZ100 7.2V 2,280mAh Rechargeable Battery",
...
"primary_offer": {
"offer_id": "0869B630C50435B49D8BD1C6990E5F26",
"offer_price": 88
},
...
},
{
"us_item_id": "11852070177",
"product_id": "5L4WQG7OVW5L",
"title": "Sony HXR-NX800 4K HDR NXCAM Camcorder (HXR-NX800) + Accessory Kit (International Model)",
...
"primary_offer": {
"offer_id": "732255FD26EE303EA58A06781FE3C027",
"offer_price": 3858
},
...
},
...
],
"filters": [
{
"name": "Brand",
"type": "brand",
"values": [
{
"id": "Sony",
"name": "Sony",
"selected": true,
"url": "https://www.walmart.com/seller/4720/cp/shopall?facet=color%3ABlack",
"serpapi_url": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=color%3ABlack&include_filters=true"
},
...
]
},
{
"name": "Color",
"type": "color",
"values": [
{
"id": "Black",
"name": "Black",
"selected": true,
"url": "https://www.walmart.com/seller/4720/cp/shopall?facet=brand%3ASony",
"serpapi_url": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=brand%3ASony&include_filters=true"
},
{
"id": "White",
"name": "White",
"url": "https://www.walmart.com/seller/4720/cp/shopall?facet=brand%3ASony%7C%7Ccolor%3ABlack%7C%7Ccolor%3AWhite",
"serpapi_url": "https://serpapi.com/search.json?catalog_seller_id=4720&engine=walmart_seller&facet=brand%3ASony%7C%7Ccolor%3ABlack%7C%7Ccolor%3AWhite&include_filters=true"
},
...
]
},
...
],
...
}
JSON structure overview
{
...
// 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. 'Sony')",
"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"
},
...
]
},
...
],
...
}