These APIs provides capability to search advertisers’ items that are part of retail catalog published on Walmart.com.
Catalog Item API endpoint limitations: Item search operation will yield a maximum of 200 primary variant items (formerly known as base items) for an advertiser. There is no limit on number of variant items that are returned for a primary variant item.
Note: Suggested bid parameter is an automated bid-price recommendation based on winning bids for recent similar ads within the category. The suggested bid values are refreshed daily.
Search items published on Walmart.com
Description: You can search an item by providing search string text or item id. List of items is pulled only from seller/supplier catalog.
URL: POST /api/v1/itemSearch
The token will provide you the access to the API. It is same for all advertisers you access through the API.
Please utilize the generated auth_token shared with you at the time of partner onboarding from the Getting Started Guide
The ID of the advertiser whose catalog item is to be retrieved
Unique numeric identifier
Text for item search. This is used to search the item against both item name and entire item description.
Terms to search an item in catalog
ID linked to the item that advertiser is selling on the Walmart portal. You can give both primary variant and variant item id in this field depending upon the requirement
Note: 1. If searching for a primary variant item, the details will be returned in response. All the variants associated with this primary variant item will be returned in the variantItems array.
2. If searching for a variant item, corresponding primary variant item details will be returned in response. All the variants associated with the primary variant item will be returned in the variantItems array.
Note: You can use either searchText or searchItemIds along with advertiserId to search an item. At least one of these is required. You must not include both.
We will provide you the consumer ID to access the API. It is same for all advertisers you access through the API.
Please use the generated ConsumerId shared with you at the time of partner onboarding. Refer to the Getting Started Guide for further explanation on this
Auth signature as an API key
Use the signature generator code from Getting Started Guide to generate this value
Timestamp for which the auth signature is generated. Use Unix epoch format for the timestamp
Use the signature generator code (Getting Started Guide) to generate this value
Sample Request when Search for Item by searchText:
Note: You will receive information of primary variant and its variants in the search results. In case a primary variant doesn’t have any variant item associated, only information belonging to primary variant is returned.
Rate limits on API operations
There is a rate
limit in place on the allowed number of API operations per hour.
Operations per hour are computed as the sum of number of changes requested across all API requests during the hour.
For example, 5 keyword bid changes, creation of an ad group, adding an item, and a snapshot report request in any given hour, would be counted as 8 operations.
receive an HTTP 429 status error code and an error message about rule enforced
in case of breaking ops limit.
To learn more
about current applicable limits specific to your integration, please reach out
to the API Partner Enablement team.