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 us https://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 us https://www.walmart.com/search?q=bear&catId=976759_1096070 where 976759_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’s filters section. However, the quickest way to discover valid filters is to:

    1. Go to Walmart.com.
    2. Run a product search and apply the filters you want.
    3. Copy the value that appears in the URL after facet=.
    For example, a search for “Chocolate” filtered by the Hershey’s brand results in the URL:
    https://www.walmart.com/search?query=Chocolate&facet=brand%3AHershey%27s

    The part after facet= 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

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=walmart_search&q=chocolate
Request
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)
Response
{
  "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

Organic Results - Electronics
GET
https://www.searchapi.io/api/v1/search?engine=walmart_search&q=electronics
Request
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)
Response
{
  ...
  "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

Other Options
GET
https://www.searchapi.io/api/v1/search?engine=walmart_search&q=Shop+jeans
Request
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)
Response
{
  ...
  "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

Filters
GET
https://www.searchapi.io/api/v1/search?engine=walmart_search&q=chocolate
Request
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)
Response
{
    "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

Variants - Coffee Maker
GET
https://www.searchapi.io/api/v1/search?engine=walmart_search&q=coffee+maker
Request
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)
Response
{
  ...
  "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"
    },
    ...
  ],
  ...
}