Walmart API endpoint
Returns Walmart search results: item id, title, brand, price, image, availability, seller, and rating per product.
/walmart/searchReturns Walmart search results.
Query parameters:
q (required) — search query, e.g. wireless earbuds.page (optional, default 1) — 1-based page number.sort (optional, default Walmart relevance). Allowed values: best_match, price_low, price_high, best_seller, new_arrivals, rating_high.Response includes query, page, total_results, and items[] (item_id, product_id, title, brand, canonical_url, image, price, price_text, currency, availability, seller_name, rating, review_count, is_sponsored).
| Field | Filled in, of 80 checked | Values in the sample |
|---|---|---|
| item_id | 80 | |
| title | 80 | “JLab Go Air Pop Bluetooth Earbuds, True Wireless with Charg…” and 61 other values |
| canonical_url | 80 | walmart.com |
| image | 80 | i5.walmartimages.com |
| images | 80 | median 1 entry |
| price | 32 | 9.88 to 179, median 19.99 |
| currency | 32 | USD in all 32 |
| availability | 32 | IN_STOCK in all 32 |
| seller_name | 32 | |
| rating | 8 | 4.1 to 5, median 4.5 |
| review_count | 8 | 12 to 86,220, median 1,031 |
| product_id | 48 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Search query | wireless earbuds | |
| page | integer | No | 1-based page number (default 1) | ||
| sort | string | No | Sort order Allowed values: best_match, price_low, price_high, best_seller, new_arrivals, rating_high. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/walmart/search?q=wireless+earbuds&page=1&sort=best_match" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "wireless earbuds",
"page": 1,
"total_results": 1200,
"items": [
{
"item_id": "6543706564",
"title": "Bose QuietComfort Earbuds, White Smoke",
"brand": "Bose",
"canonical_url": "https://www.walmart.com/ip/6543706564",
"price": 179,
"price_text": "$179.00",
"currency": "USD",
"availability": "IN_STOCK",
"seller_name": "Walmart.com",
"rating": 4.4,
"review_count": 1203
}
]
}
}Request schema
No body schema
Response schema
#/definitions/walmart.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | walmart.SearchResponse | No | ||||
| data.items | array | No | ||||
| data.items[].availability | string | No | IN_STOCK | |||
| data.items[].brand | string | No | Apple | |||
| data.items[].canonical_url | string | No | https://www.walmart.com/ip/5689919121 | |||
| data.items[].currency | string | No | USD | |||
| data.items[].image | string | No | https://i5.walmartimages.com/seo/example.jpeg | |||
| data.items[].images | array | No | ||||
| data.items[].is_sponsored | boolean | No | false | |||
| data.items[].item_id | string | No | 5689919121 | |||
| data.items[].price | number | No | 169 | |||
| data.items[].price_text | string | No | $169.00 | |||
| data.items[].product_id | string | No | 5689919121 | |||
| data.items[].rating | number | No | 4.6 | |||
| data.items[].review_count | integer | No | 17823 | |||
| data.items[].seller_name | string | No | Walmart.com | |||
| data.items[].title | string | No | Apple AirPods Pro 2 | |||
| data.page | integer | No | 1 | |||
| data.query | string | No | lego | |||
| data.total_results | integer | No | 1200 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/walmart/search?q=wireless+earbuds&page=1&sort=best_match" \
-H "x-api-key: $CRAWLORA_API_KEY"