The item search API allows you to query the Walmart.com global product catalog by item keyword, UPC, GTIN, or ASIN. You can review all item information provided in the response, so you can decide whether or not you want to sell this item.

For keyword and identifier searches (responseFormat=DEFAULT), the search returns up to 40 matching items. For spec searches (responseFormat=SPEC), the response contains a single item in spec format, or an empty response if the identifier is not found. responseFormat accepts: SPEC or DEFAULT (defaults to DEFAULT when omitted).

The item search API returns only items that are currently in a published status. Items that are unpublished, such as out-of-stock items or items affected by publishing restrictions, do not appear in search results.

Spec Response Format (responseFormat=SPEC):
When responseFormat=SPEC is specified, the API returns item data in spec-compliant format (Full Item Spec — MP_ITEM, or Item setup by match — MP_ITEM_MATCH) suitable for direct submission as a setup feed. This enables sellers to search and set up items in a single workflow. For spec format responses, the feed version corresponds to the latest recommended version documented on the Item Spec Versioning page.

Validation Rules:

• At least one of query, upc, gtin, or asin must be provided
• When responseFormat=SPEC:
  • Exactly one identifier (gtin, upc, or asin) must be supplied — returns 400 if none or multiple are provided
  • query (keyword search) is not supported — returns 400
• asin is only supported with responseFormat=SPEC — returns 400 otherwise

Throttling:
For details on throttling, refer to the Walmart throttling documentation.