Walmart Product Search

Walmart Product Search is used to fetch product search results from Walmart.

Fetch product results by keyword
Support page-based result pagination
Return organic results, recommendation blocks, and filters
Suitable for product discovery and custom ecommerce result workflows

Use XCrawl to Fetch Walmart Product Search Results

Usage

curl -s -X POST 'https://run.xcrawl.com/v1/data' \
  -H 'Authorization: Bearer $XCRAWL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "engine": "walmart_search",
    "location": "US",
    "keyword_list": ["coffee"],
    "start_page": 1,
    "pages": 1
  }'

Request parameter notes:

engine must be walmart_search
location specifies the target region
keyword_list accepts one or more keywords
start_page specifies the start page
pages specifies how many pages to fetch

Response Example

{
  "result": [
    {
      "page": 2,
      "total_page": 11,
      "organic_results": [
        {
          "product_id": "264873080",
          "title": "Black Rifle Coffee Company Beyond Black K-Cup Pods",
          "line_price": "$16.96"
        }
      ]
    }
  ]
}

Parameters

Required Parameters

Parameter	Type	Description
`location`	`string`	Specifies the target region.
`keyword_list`	`array`	Accepts one or more keywords.
`start_page`	`number`	Start page number.
`pages`	`number`	Number of pages to fetch.

Parameter Notes

location defaults to US
start_page defaults to 1
pages defaults to 1

Response Fields

Response data is returned under result[].

Field	Type	Description
`page`	`number`	Current page number.
`total_page`	`number`	Total page count.
`organic_results_counts`	`number`	Organic result count.
`other_options_to_consider_results_counts`	`number`	Recommendation block result count.
`organic_results`	`array`	Organic result list.
`other_options_to_consider_results`	`array`	Recommendation block list.
`filters`	`array`	Filter data.
`related_queries`	`array`	Related query list.

Product Result Fields

Common fields in organic_results[] and other_options_to_consider_results[] include:

Field	Type	Description
`product_id`	`string`	Product id.
`title`	`string`	Product title.
`thumbnail_url`	`string`	Product thumbnail URL.
`rating`	`number`	Product rating.
`reviews`	`number`	Review count.
`seller_name`	`string`	Seller name.
`availability_status`	`string`	Availability status.
`line_price`	`string`	Display price.
`unit_price`	`string`	Unit price.
`product_page_url`	`string`	Product page URL.

SERP

Engines

Data

APIs