Place a Request for Item Recommendations

Description: You can place a request for item or keyword recommendations by providing advertiser ID, recommendation type and format.

URL: ​POST/api/v1/snapshot/recommendations

Query Parameters

ParameterNotesType Required  Possible Values
advertiserIdThe id of advertiserintegerYThe advertiser Id for which the recommendation is to be retrieved  
recommendationTypeThe type of the recommendation requiredstringYValues of recommendation type: itemRecommendations, keywordRecommendations
formatChoose the format type for your snapshotstringYTypes of formats: gzip, zip Note: gzip allows decompression while file is being transferred over the network, hence it is a faster and simpler way to download the reports

Headers

Headers

Header NameDescriptionRequiredValues
AuthorizationThe token will provide you the access to the API. It is same for all advertisers you access through the API.YPlease utilize the generated auth_token shared with you at the time of partner onboarding from the Getting Started Guide
WM_CONSUMER.IDWe will provide you the consumer ID to access the API. It is same for all advertisers you access through the API.   YPlease use the generated ConsumerId shared with you at the time of partner onboarding. Refer to the Getting Started Guide for more information
WM_SEC.AUTH_SIGNATUREAuth signature as an API key.YUse the signature generator code from Getting Started Guide to generate this value
WM_SEC.KEY_VERSIONWe will provide you with the KEY VERSION to access the API. It is same for all advertisers you access through the API.Y1
WM_CONSUMER.intimestampTimestamp for which the auth signature is generated. Use Unix epoch format for the timestamp.YUse the signature generator code from Getting Started Guide to generate this value

Sample Request

curl -X POST \
'https://developer.api.stg.walmart.com/api-proxy/service/WPA/Api/v1/api/v1/snapshot/recommendations' \
--header 'Authorization: Bearer <auth_token>' \ --header 'accept: application/json' \
--header 'WM_SEC.AUTH_SIGNATURE: ***********' \
--header 'WM_SEC.KEY_VERSION: 1' \ --header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \
--header 'WM_CONSUMER.intimestamp: 1565309779' \
--header 'Content-Type: application/json' \
--data '{ "advertiserId" : "600001", "recommendationType": "itemRecommendations", "format": "gzip" }'

Response

Element DescriptionType
codeThe response code can have following values:• success • failurestring
detailsDetails of the error if value of response code is failurestring
snapshotIdID of the snapshotstring
jobStatusIt is an indicator to confirm status of snapshot generation. The possible values of jobStatus are: pending, processing, done, failed, expiredstring

Sample Response

[ { "code": "success", "snapshotId": "15467655-92ef-490d-a2c8-0157990f57f8", "details": " ", " jobStatus ": "pending" }
]