Scraper · Walmart
walmart.search
The products on a page of Walmart's search results: prices, ratings, sellers, with advertisements marked.
- Id
walmart.search- Version
- 1
- Billed per
- request — 1 unit for a charged run
- Runs
- within one request
Start it with POST /v1/scrapers/walmart.search/runs. How runs work is in Running a scraper; what a run costs is in Usage and units.
Inputs
The fields of input. A field that is not listed here is refused.
| Field | Type | Description |
|---|---|---|
queryrequired | string | What to search for, e.g. "wireless mouse".Limit: at least 1 characters, at most 200 characters. |
page | integer | The results page, from 1 (Walmart serves at most 25).Limit: 1 to 25. Default: 1. |
max_results | integer | Return at most this many items of the page; all of them when not given.Limit: 1 to 100. |
sort | "best_match" | "price_low" | "price_high" | Walmart's sort order.Default: "best_match". |
include_sponsored | boolean | False leaves the advertisements (sponsored: true) out.Default: true. |
- One run reads one page of results; ask for the next with
page.
Record fields
Every record of a run has these fields. A value that is not known is null — never an empty string and never 0.
| Field | Type | Notes |
|---|---|---|
item_id | string | Walmart's item id (usItemId): the number at the end of the product's address. |
product_id | string or null | Walmart's internal product id. |
url | string or null | The product's address, without tracking parameters. |
title | string | Always present. |
price | object or null | The price shown on the tile. |
amount (in price) | number | The amount as the page states it. |
currency (in price) | string or null | The currency code the page gives with the amount (USD on walmart.com); null when it gives none. |
was_price | object or null | The struck-through earlier price, when the tile shows one. |
amount (in was_price) | number | The amount as the page states it. |
currency (in was_price) | string or null | The currency code the page gives with the amount (USD on walmart.com); null when it gives none. |
rating | number or null | Average rating, 0 to 5. |
review_count | integer or null | Number of reviews. |
brand | string or null | Brand, when the results page states it (it usually does not; the product page does). |
seller_name | string or null | null when not known. |
seller_id | string or null | null when not known. |
availability | string or null | Walmart's availability code, e.g. IN_STOCK. |
in_stock | boolean or null | null when not known. |
fulfilment_type | string or null | Walmart's code for where the item ships from: STORE, FC (fulfilment centre) or MARKETPLACE. |
fulfilment_options | array of string | How the item can be had: PICKUP, DELIVERY. |
sponsored | boolean or null | True for an advertisement (a sponsored placement), false for a result; null only when the page does not say. |
badge | string or null | The label on the tile, e.g. Best seller, Rollback, Overall pick. |
image | string or null | null when not known. |
match | "exact" | "related" or null | exact: Walmart lists the item as a result for the query; related: under "Other options to consider" (shown when few or no items match); null when the page does not say. |
position | integer | The item's place among the returned items of this page, from 1. |
page | integer | The results page the item was on. |
fetched_at | string (date-time) | Always present. |
Example request
curl -X POST "https://api.enrichednow.com/v1/scrapers/walmart.search/runs?wait=60" \
-H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"query":"wireless mouse"}}'The body on its own:
{
"input": {
"query": "wireless mouse"
}
}Example response
The run, once it has ended. A run that has not ended within wait comes back with 202 and the status queued or running.
{
"id": "run_6cce2b12aaf37a10b5e1b885",
"scraper_id": "walmart.search",
"scraper_version": 1,
"status": "ok",
"reason": null,
"input": {
"query": "wireless mouse"
},
"record_count": 1,
"units": 1,
"diagnostics": {
"requests": 1,
"bytes": 232779,
"wall_ms": 565,
"facts": {}
},
"created_at": "2026-11-16T20:27:29.009834Z",
"started_at": "2026-11-16T20:27:29.013803Z",
"finished_at": "2026-11-16T20:27:29.582787Z"
}Its records, from GET /v1/runs/{id}/records (the values are an illustration; the fields are the ones above):
{
"records": [
{
"item_id": "string",
"product_id": null,
"url": null,
"title": "string",
"price": null,
"was_price": null,
"rating": null,
"review_count": null,
"brand": null,
"seller_name": null,
"seller_id": null,
"availability": null,
"in_stock": null,
"fulfilment_type": null,
"fulfilment_options": [],
"sponsored": null,
"badge": null,
"image": null,
"match": null,
"position": 0,
"page": 0,
"fetched_at": "2026-01-01T00:00:00Z"
}
],
"next_cursor": null
}A run does not always end ok. Results and statuses lists every status and the reasons every scraper shares.