Walmart catalog item search

Use the Item Search API request to determine if Walmart already has the item you’re selling. This API request lets you search for an existing item in the Walmart catalog using item keywords (such as MacBook or Apple), or a specific identifier such as UPC, or GTIN.

You must specify at least one search parameter, either: query (keyword), GTIN, or UPC. You can pass multiple query parameters and use filters to get detailed results. The search results yield items that are currently listed in Walmart. If there are more than one item in the catalog, the search returns the first 20 items in the response.

You can review the product details to decide whether you want to add an offer for the specific item. If you want to add a similar item that exists in our catalog, you can use the item setup info that is displayed in the search results.

Additionally, you can use the information provided in the relatedQueries response parameter to run a new search for similar items.

1. Call /v3/items/catalog/search resource, and specify the correct payload with Query, Filter, and Sort.

   • Allowed fields for Query: productName, sku, gtin, wpid, upc, isbn, ean, itemId
   • Allowed fields for Filters: num_reviews, customerRating, lifecycleStatus, publishedStatus, unpublishedReasons, inventoryStatus, price, fulfillmentType
   • Allowed fields for Sort: num_reviews, customerRating, lifecycleStatus, publishedStatus, unpublishedReasons, inventoryStatus

2. You must provide either a Query or Filter to execute search API call.
   NOTE: When making an API call, the Sortparameter alone is not sufficient and must be accompanied by either a Query or a Filterparameter to avoid an error response.

3. Only one query is allowed but multiple filters are acceptable.

4. Wildcard search is supported for Query. Use % to present the unknown letters. For example, %item finds strings that end with item, item% finds strings that start with item and %item% finds strings that contain item.