{"uid":"cap_OurLkAqXbOAwWzQwkjSaW","slug":"walmart-product-search-f469ac01","name":"Walmart Product Search","description":"Search Walmart products by keyword.","url":"https://openwebninja-x402.vercel.app/api/walmart/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["query"],"properties":{"zip":{"type":"string","minLength":1},"page":{"type":"number","minimum":1},"facet":{"type":"string","minLength":1},"query":{"type":"string","minLength":1},"state":{"type":"string","maxLength":8,"minLength":2},"domain":{"enum":["us","ca"],"type":"string"},"sort_by":{"enum":["best_match","price_low","price_high","best_seller","top_rated"],"type":"string"},"store_id":{"type":"string","minLength":1},"max_price":{"type":"number","minimum":0},"min_price":{"type":"number","minimum":0}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"zip":"90210","page":1,"query":"wireless earbuds","domain":"us","sort_by":"price_low","max_price":50}}},"response":{"_truncated":true,"_originalSize":94866}},"exampleRequest":{"zip":"90210","page":1,"query":"wireless earbuds","domain":"us","sort_by":"price_low","max_price":50},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0CTsiXyD499kwG7ZIQymv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Walmart's product catalog by keyword with filtering by price, location, category, and sort order","exampleAgentPrompt":"Search Walmart for 'wireless earbuds' in the US, sorted by price low to high, with a max price of $50, near ZIP code 90210, and show me page 1 of results.","exampleUseCases":[{"title":"Find budget-friendly electronics for family","prompt":"Search Walmart for affordable laptops under $400 near my ZIP code 10001 so I can pick one up locally this week."},{"title":"Compare pricing on grocery essentials","prompt":"Look up organic milk and eggs on Walmart Canada, sorted by price from lowest to highest, so I can see what's available in my area."},{"title":"Discover top-rated home appliances quickly","prompt":"Find me the best-selling air purifiers on Walmart with prices between $100 and $300, sorted by customer rating to see what people love most."}],"resultDescription":"Returns a list of Walmart product listings matching the search query, including product names, prices, ratings, availability, and other catalog details filtered and sorted according to the specified parameters.","failureModes":["Missing required 'query' parameter returns validation error","Invalid domain value (not 'us' or 'ca') causes schema rejection","Invalid sort_by enum value rejected by schema","Page number below 1 rejected by schema","min_price or max_price below 0 rejected","ZIP code format issues may return no local results","Payment failure (insufficient USDC) blocks the request"],"whenToPreferThis":"Use this endpoint when you need to search Walmart's product catalog programmatically — especially when you need price-range filtering, location-aware results via ZIP code, Canadian Walmart support, or specific sort orders like best seller or top rated. Prefer this over Amazon search endpoints when the user specifically wants Walmart pricing or availability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":44,"lastUsedAt":"2026-06-20T19:28:45.914Z","lastSuccessfullyRanAt":"2026-06-20T19:28:45.914Z","lastHealthCheckAt":"2026-09-15T00:40:14.859Z","isFirstParty":false}