Walmart Public Products API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 · stringWalmart category ID, for example 976759_1086446.
Example: 976759_1086446
Response
notesstring[]filtersobject[]filters[].namestringfilters[].labelstringfilters[].values?object[]filters[].values[].facetstringfilters[].values[].labelstringfilters[].values[].source_urlstringsource_urlstringcategory_idstringFields 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 · stringWalmart category ID, for example 976759_1086446.
Example: 976759_1086446
pageOptionalQuery · integer, min: 1, default: 1Walmart category page number, starting at 1.
Example: 1
facetOptionalQuery · string | nullA Walmart facet expression returned by filter discovery.
Example: brand:Folgers
sortOptionalQuery · string, default: best_matchWalmart sort expression.
Example: best_match
Response
query?string | nulltitle?string | nullcategory?object | nullmax_page?integer | nullproductsobject[]products[].name?string | nullproducts[].brand?string | nullproducts[].price?objectproducts[].price.unit?string | nullproducts[].price.amount?number | nullproducts[].price.display?string | nullproducts[].price.currency?string | nullproducts[].rating?number | nullproducts[].image_url?string | nullproducts[].product_idstringproducts[].unit_price?objectproducts[].unit_price.unit?string | nullproducts[].unit_price.amount?number | nullproducts[].unit_price.display?string | nullproducts[].unit_price.currency?string | nullproducts[].us_item_id?string | nullproducts[].source_data?objectproducts[].availability?string | nullproducts[].review_count?integer | nullproducts[].canonical_urlstringproducts[].catalog_product_type?string | nullsource_urlstringbreadcrumbs?object[]source_data?objectsource_total?integer | nullreturned_countintegerpage_properties?objectsource_page_count?integer | nullFields 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 · stringWalmart product ID returned by another operation.
Example: 3MHEPBZONQXL
Response
name?string | nullbrand?string | nullprice?objectprice.unit?string | nullprice.amount?number | nullprice.display?string | nullprice.currency?string | nullimagesobject[]offersobject[]rating?number | nullsellerobjectseller.id?string | nullseller.name?string | nullseller.type?string | nullreviewsobjectreviews.itemsobject[]reviews.summary?object | nullreviews.returned_countintegercategory?object | nullvariantsobjectprice_info?objectproduct_idstringsource_urlstringunit_price?objectunit_price.unit?string | nullunit_price.amount?number | nullunit_price.display?string | nullunit_price.currency?string | nullus_item_idstringdescription?string | nullfulfillmentunknown[]source_data?objectavailability?string | nullreview_count?integer | nullcanonical_urlstringreturn_policy?object | nulldisplay_variant_id?string | nullprimary_product_id?string | nullFields 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 · stringThe text Walmart searches for.
Example: coffee
pageOptionalQuery · integer, min: 1, default: 1Walmart result page number, starting at 1.
Example: 1
facetOptionalQuery · string | nullA Walmart facet expression returned by filter discovery.
Example: brand:Folgers
sortOptionalQuery · string, default: best_matchWalmart sort expression.
Example: best_match
Response
query?string | nulltitle?string | nullcategory?object | nullmax_page?integer | nullproductsobject[]products[].name?string | nullproducts[].brand?string | nullproducts[].price?objectproducts[].price.unit?string | nullproducts[].price.amount?number | nullproducts[].price.display?string | nullproducts[].price.currency?string | nullproducts[].rating?number | nullproducts[].image_url?string | nullproducts[].product_idstringproducts[].unit_price?objectproducts[].unit_price.unit?string | nullproducts[].unit_price.amount?number | nullproducts[].unit_price.display?string | nullproducts[].unit_price.currency?string | nullproducts[].us_item_id?string | nullproducts[].source_data?objectproducts[].availability?string | nullproducts[].review_count?integer | nullproducts[].canonical_urlstringproducts[].catalog_product_type?string | nullsource_urlstringbreadcrumbs?object[]source_data?objectsource_total?integer | nullreturned_countintegerpage_properties?objectsource_page_count?integer | nullFields 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.
An account is required to submit an extension. Prepare your request, then sign in to build.