Catalog / Walmart Public Products

Walmart Public Products API

walmart.com

Read-only, live access to Walmart's anonymous public product pages and browse/search pages. Use product IDs returned by search or category results with the product detail operation. Prices and availability are observations for the request's anonymous market context and can change. Cart, checkout, account, reservation, and other write or authenticated flows are not exposed.

  • shopping
  • Walmart
  • products
  • search
  • catalog
4 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Walmart Public Products API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Returns filter controls and values Walmart rendered on the selected category page. Values are contextual, not a universal taxonomy. A filter value's `facet` can be passed unchanged to category browsing or product search where Walmart accepts it. Some controls (notably numeric price entry) expose no finite value list.

Walmart category ID, for example 976759_1086446.

View call pricing
cURL · Categories by category id filters
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/7876564d-87c2-4a9b-9f2a-a4fc33c7ab88/v1/categories/976759_1086446/filters' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETCategories by category id filters/v1/categories/{category_id}/filters

Returns filter controls and values Walmart rendered on the selected category page. Values are contextual, not a universal taxonomy. A filter value's `facet` can be passed unchanged to category browsing or product search where Walmart accepts it. Some controls (notably numeric price entry) expose no finite value list.

Input

category_idRequiredPath · string

Walmart category ID, for example 976759_1086446.

Example: 976759_1086446

Response

notesstring[]
filtersobject[]
filters[].namestring
filters[].labelstring
filters[].values?object[]
filters[].values[].facetstring
filters[].values[].labelstring
filters[].values[].source_urlstring
source_urlstring
category_idstring

Fields marked ? are optional.

GETCategories by category id products/v1/categories/{category_id}/products

Reads a Walmart category page by its source category ID. Obtain category IDs from Walmart canonical browse URLs or breadcrumbs returned by this operation. Use a facet returned by category filter discovery to apply a source-supported category filter.

Input

category_idRequiredPath · string

Walmart category ID, for example 976759_1086446.

Example: 976759_1086446

pageOptionalQuery · integer, min: 1, default: 1

Walmart category page number, starting at 1.

Example: 1

facetOptionalQuery · string | null

A Walmart facet expression returned by filter discovery.

Example: brand:Folgers

sortOptionalQuery · string, default: best_match

Walmart sort expression.

Example: best_match

Response

query?string | null
title?string | null
category?object | null
max_page?integer | null
productsobject[]
products[].name?string | null
products[].brand?string | null
products[].price?object
products[].price.unit?string | null
products[].price.amount?number | null
products[].price.display?string | null
products[].price.currency?string | null
products[].rating?number | null
products[].image_url?string | null
products[].product_idstring
products[].unit_price?object
products[].unit_price.unit?string | null
products[].unit_price.amount?number | null
products[].unit_price.display?string | null
products[].unit_price.currency?string | null
products[].us_item_id?string | null
products[].source_data?object
products[].availability?string | null
products[].review_count?integer | null
products[].canonical_urlstring
products[].catalog_product_type?string | null
source_urlstring
breadcrumbs?object[]
source_data?object
source_total?integer | null
returned_countinteger
page_properties?object
source_page_count?integer | null

Fields marked ? are optional.

GETProducts by product id/v1/products/{product_id}

Retrieves one Walmart product by the source product identifier returned in search/category results. The response includes the public current offer observation, variants, seller, fulfillment, images, and the reviews Walmart included in the product page. It does not add-to-cart or purchase.

Input

product_idRequiredPath · string

Walmart product ID returned by another operation.

Example: 3MHEPBZONQXL

Response

name?string | null
brand?string | null
price?object
price.unit?string | null
price.amount?number | null
price.display?string | null
price.currency?string | null
imagesobject[]
offersobject[]
rating?number | null
sellerobject
seller.id?string | null
seller.name?string | null
seller.type?string | null
reviewsobject
reviews.itemsobject[]
reviews.summary?object | null
reviews.returned_countinteger
category?object | null
variantsobject
price_info?object
product_idstring
source_urlstring
unit_price?object
unit_price.unit?string | null
unit_price.amount?number | null
unit_price.display?string | null
unit_price.currency?string | null
us_item_idstring
description?string | null
fulfillmentunknown[]
source_data?object
availability?string | null
review_count?integer | null
canonical_urlstring
return_policy?object | null
display_variant_id?string | null
primary_product_id?string | null

Fields marked ? are optional.

GETSearch products/v1/search/products

Searches Walmart's public product search. Results are source-ranked and may contain sponsored or grouped items. `facet` is Walmart's source facet expression, such as `brand:Folgers`, obtained from category filter discovery; it is not an arbitrary local filter. `page` is the source page number.

Input

qRequiredQuery · string

The text Walmart searches for.

Example: coffee

pageOptionalQuery · integer, min: 1, default: 1

Walmart result page number, starting at 1.

Example: 1

facetOptionalQuery · string | null

A Walmart facet expression returned by filter discovery.

Example: brand:Folgers

sortOptionalQuery · string, default: best_match

Walmart sort expression.

Example: best_match

Response

query?string | null
title?string | null
category?object | null
max_page?integer | null
productsobject[]
products[].name?string | null
products[].brand?string | null
products[].price?object
products[].price.unit?string | null
products[].price.amount?number | null
products[].price.display?string | null
products[].price.currency?string | null
products[].rating?number | null
products[].image_url?string | null
products[].product_idstring
products[].unit_price?object
products[].unit_price.unit?string | null
products[].unit_price.amount?number | null
products[].unit_price.display?string | null
products[].unit_price.currency?string | null
products[].us_item_id?string | null
products[].source_data?object
products[].availability?string | null
products[].review_count?integer | null
products[].canonical_urlstring
products[].catalog_product_type?string | null
source_urlstring
breadcrumbs?object[]
source_data?object
source_total?integer | null
returned_countinteger
page_properties?object
source_page_count?integer | null

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.