Walmart API

Walmart Search API

Search Walmart by keyword with optional sort, price-range, facet, and page filters and get title, price, rating, seller, and availability for each product in one normalized response.

POST/v1/run/walmart.search
Uptime
99.71%
30d · 2,063 calls
Requests
2,063
30d · weekly, last 12 wks
Response
3.4s
median · 30d

Pricing and providers

Walmart Search API pricing: one API, 2 interchangeable providers

The cheapest provider serves first. If it fails, the next one takes over in the same call.

You pay
$9.00
$0.90/1k req, only for what you use. No monthly plan.
Your first 111 requests are free with the $0.10 starting balance.

Try it

Get Walmart search in one request

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `totalPages`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
  "data": {
    "items": [
      {
        "availability": "example",
        "brand": "Acme Inc",
        "currency": "USD",
        "image": "https://example.com/image.jpg",
        "inStock": true,
        "isSponsored": true,
        "itemId": "a1b2c3d4",
        "listPrice": 19.99,
        "position": 1,
        "price": 19.99,
        "rating": 4.6,
        "reviewsCount": 12500,
        "sellerId": "a1b2c3d4",
        "sellerName": "Example title",
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ],
    "totalPages": 12500,
    "totalResults": 12500
  },
  "found": true,
  "reason": "not_found"
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

One request, one response shape.

Every field you send and every field you get back, each with a real example.

Last verified 2026-11-21 · uptime and latency measured over 30d

Request body

JSON, posted to this endpoint.

  • querystring

    airpods

    Search keywords, e.g. "airpods" or "paper towels".

  • facetstring

    Optional Walmart facet filter token, e.g. brand:HP to keep only HP products.

  • maxPricenumber

    Optional maximum product price in USD.

  • minPricenumber

    Optional minimum product price in USD.

  • pageinteger

    1-based results page of about 40 to 60 products; Walmart serves no products past page 10. Each page is billed as one request. Walmart re-ranks between requests, so consecutive pages can repeat a product: deduplicate on itemId.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `totalPages`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.

  • sortenum

    best_seller

    Result sort order; omit for Walmart's Best Match (e.g. price_low sorts by lowest price first).

You send. A small JSON body. The values shown are examples to replace with your own.

Response

JSON, one example value per field.

each itemdata.items[]

Matching Walmart product records for the requested page. Populated whenever the provider has data for the entity.

  • availabilitystring

    Stock status as Walmart reports it, e.g. "IN_STOCK" or "OUT_OF_STOCK".

  • brandstring

    Brand name, or null when Walmart omits it from the search grid (it publishes brand on clothing-style grids and on no row elsewhere; the Walmart Product SKU always carries it).

  • currencystring

    Price currency code, e.g. "USD"; empty when no price is shown.

  • imagestring

    Primary product image URL. Populated whenever the provider has data for the entity.

  • inStockboolean

    True when the product is in stock, false when it is not, or null when not reported.

  • isSponsoredboolean

    True when the result is a sponsored placement.

  • itemIdstring

    Walmart US item id (usItemId), the number in a walmart.com/ip/ URL; use the product URL with the Walmart Product or Walmart Reviews SKU. Populated whenever the provider has data for the entity.

  • listPricenumber

    Pre-discount "was" price when the product is on sale, or null when it is not discounted.

  • positioninteger

    1-based position of the result in this page.

  • pricenumber

    Current price in USD as a number, or null when the result shows no current price. Populated whenever the provider has data for the entity.

  • ratingnumber

    Average customer rating, 0-5, or null when the product is unrated.

  • reviewsCountinteger

    Number of customer ratings, or null when the product has none.

  • sellerIdstring

    Identifier of the seller fulfilling the shown offer.

  • sellerNamestring

    Name of the seller fulfilling the shown offer.

  • titlestring

    Product title. Populated whenever the provider has data for the entity.

  • urlstring

    Walmart product page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.

datadata

Search result wrapper, or null when nothing matched.

  • totalPagesintegercan require

    Highest page number available for the query; request pages 1 through this value. Absent or null when the serving source does not report it.

  • totalResultsinteger

    Total number of matching products Walmart reports for the query, or null when not reported.

top level
  • foundboolean

    True when the search returned at least one product.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

You get back. Named, typed fields in the same shape whichever source answers.

FAQ

About the Walmart Search API

The AnyAPI Walmart Search API returns Walmart search data as normalized JSON from one POST call to /v1/run/walmart.search. Search Walmart by keyword with optional sort, price-range, facet, and page filters and get title, price, rating, seller, and availability for each product in one normalized response. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $0.90 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 99.7% of Walmart search calls through AnyAPI succeeded, with a median response time of 3.4 seconds across 2,063 measured calls.

It costs from $0.90 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet and each call draws it down. Some failed wallet-funded requests incur processing charges that we pass through at cost, with no markup; the error response shows the amount charged.

Search Walmart by keyword with optional sort, price-range, facet, and page filters and get title, price, rating, seller, and availability for each product in one normalized response. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 99.7% of Walmart search calls through AnyAPI succeeded, with a median response time of 3.4 seconds across 2,063 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.

Yes. A new AnyAPI account starts with $0.10 of free balance and no card required, which covers 111 Walmart Search calls at $0.0009 each.

AnyAPI asks the next of its 2 sources in the same request, cheapest first, so one source going down does not fail your call.

Send a POST request to https://api.getanyapi.com/v1/run/walmart.search with your AnyAPI key in an "Authorization: Bearer" header and the input as a JSON body. The same key and the same wallet work on every AnyAPI endpoint.

No. You add US dollars to one prepaid AnyAPI balance and each request draws it down. There is no monthly plan and no minimum, and the same balance pays for every AnyAPI endpoint.

Yes. Install @getanyapi/sdk from npm for TypeScript or getanyapi from pip for Python. Both call every AnyAPI endpoint with the same key, and any HTTP client works too.

Yes. An agent can connect to the AnyAPI MCP server at https://api.getanyapi.com/mcp, or create its own free-trial key with one unauthenticated POST to https://api.getanyapi.com/agent/signup and call this endpoint over HTTP.