Walmart Snapshot API
ADD ITEM ID TO WALMART SNAPSHOT QUERY QUEUE
The request to add Item Id to Walmart Snapshot query queue.
CREDIT DEDUCTION
1 (one) credit deduction after successful retrieval of data.
REQUEST
| URI | /api/query/walmart/add/itemid/{itemid}? secretKey={secretKey} | {itemid} – required – the item id to add to queue |
| Example | /api/query/walmart/add/itemid/229596647?&secretKey= xxxxxxxxxx | |
RESPONSE
| Headers | |
| MediaType | application/json |
| JSON Data |
{
"status": "OK",
"allowed": 4971,
"messageId": null,
"message": null,
"data": null,
"rid": "58eb4fb8bfc2333894ce7dc7",
"dateProcessed": null
}
Note: During callback, the rid can be used to link the callback data to the original request call.
WALLMART SNAPSHOT QUERY CALLBACK
WALLMART SNAPSHOT QUERY CALLBACK REQUEST
| URI | Example: https://your.server.com/amzpecty_result | {Please provide URL in Preferences Page} URL must be SSL enabled. AMZPECTY-API-SECRET-KEY (header name) – secret key header will be included for the call back server to validate the request origin |
| Example | application/json | |
WALLMART SNAPSHOT QUERY CALLBACK JSON SAMPLE DATA
| Headers | |
| MediaType | application/json |
| JSON Data |
{
"status": "OK",
"responsefor": "walmartsnapshot",
"allowed": 4898,
"dailyAllowed": 1000,
"messageId": null,
"message": null,
"data": {
"itemid": "348542223",
"itemName": "Fitbit Sense Lunar White Soft Gold",
"brand": "Fitbit",
"averageRating": "4.1",
"numberOfReviews": "14",
"totalQty": 588,
"buyboxPrice": "249.95",
"buyboxSellerName": "Walmart.com",
"buyboxSellerId": "0",
"buyboxOfferListingId": "E3F5B59136DC4D46834296FA71307C97",
"buyboxArriveStart": "Sunday, Jun 13",
"totalProSeller": 2,
"maxPrice": "409.03",
"minPrice": "249.95",
"avgPrice": "303.74",
"totalOffers": 10,
"offers": [
{
"sellerName": "Walmart.com",
"condition": "NEW",
"price": 249.95,
"priceShipping": 0,
"priceTotal": 249.95,
"inventoryCount": 560,
"moq": false,
"moqvalue": 10,
"proSeller": false,
"sellerId": "0",
"offerListingId": "E3F5B59136DC4D46834296FA71307C97",
"arriveStart": "Sunday, Jun 13",
"availability": "ONLINE_AND_STORE",
"published": true
},
{
"sellerName": "Heart Rate Monitors USA",
"condition": "NEW",
"price": 259.95,
"priceShipping": 0,
"priceTotal": 259.95,
"inventoryCount": 6,
"moq": false,
"moqvalue": 5,
"proSeller": true,
"sellerId": "1217",
"offerListingId": "E3F5B59136DC4D46834296FA71301234",
"arriveStart": "Jun 15",
"availability": "IN_STOCK",
"published": true
}
]
},
"rid": "5f87e47ae4b0a11203a328ea",
"dateProcessed": 1602741386150
}
WALMART SNAPSHOT QUERY CALLBACK RESPONSE JSON ATTRIBUTES
| Attribute Name | Details |
|---|---|
| status | The status of the request. “OK” for good results |
| responsefor | “walmartsnapshot” value for Walmart Snapshot query result. |
| allowed | The current allowed request count. Resets monthly. |
| dailyAllowed | The current allowed daily request count. Resets daily. |
| messageId | The id of the message (if any) . |
| message | The actual message (if any). Please refer to Error Messages. |
| rid | The request id. This can be used in the Get query as a key. |
| domain | The corresponding Amazon domain for the Seller. |
| dateProcessed | The date the request was processed unix time format. |
| data.itemId | The Item Id of the product. |
| data. itemName | The item name of the product. |
| data. brand | The brand name of the product. |
| data.averageRating | The average star rating of this item. |
| data.numberOfReviews | The number of reviews of this item. |
| data. totalQty | The estimated Total Quantity of the product. |
| data. buyboxPrice | The buy box price. |
| data. buyboxSellerName | The buy box seller name. |
| data. buyboxSellerId | The buy box seller id. |
| data. buyboxOfferListingId | The buy box offer listing id. |
| data. buyboxArriveStart | The buy box arrival/delivery start date. |
| data. totalProSeller | The total count of Pro sellers |
| data. maxPrice | The maximum price of all offers of this product. |
| data. minPrice | The minimum price of all offers of this product. |
| data. avgPrice | The average price of all offers of this product. |
| data. totalOffers | The total number of offers of this product. |
| data. offers[] | The list of offers of the product. |
| offers[n]. sellerName | The seller name of the seller offering the product. |
| offers[n]. condition | The condition of the product. |
| offers[n]. price | The price of the product. |
| offers[n]. priceShipping | The shipping fee of this product offer. |
| offers[n]. priceTotal | The sum of price and shipping of this product offer. |
| offers[n]. inventoryCount | The quantity available offered by the seller of this product. |
| ~offers[n]. moq~ | ~The minimum order quantity flag of this offer. (If seller imposes MOQ)~ |
| ~offers[n]. moqvalue~ | ~The actual minimum order quantity value of this offer. (If seller imposes MOQ)~ |
| offers[n].proSeller | The Pro seller flag. “true“ or “false“ |
| offers[n].sellerId | The seller id of the seller of this offer. |
| ~offers[n].offerListingId~ | ~The offer listing id.~ |
| offers[n].arriveStart | The arrival/delivery start date of this offer. |
| offers[n].availability | The availability of this offer. “ONLINE_AND_STORE”, “IN_STOCK” etc. |
| offers[n].published | The published flag. “true“ or “false“ |
Note: New fields may be added or removed from the JSON response.
GET WALMART SNAPSHOT RESULT BY ITEM ID
The request to get the latest Walmart Snapshot result by Item Id.
CREDIT DEDUCTION
0 (zero) credit deduction for the Get call.
REQUEST
| URI | /api/query/walmart/get/itemid/{itemid}? secretKey={secretKey} | {itemid} – the item id to get most recent tracking list |
| Example | /api/query/walmart/get/itemid/229596647? secretKey= xxxxxxxxxx | |
RESPONSE
See Walmart Snapshot Query Callback JSON Sample Data
GET WALMART SNAPSHOT RESULT BY REQUEST ID
The request to get the latest Walmart Snapshot result by Request Id (rid).
CREDIT DEDUCTION
0 (zero) credit deduction for the Get call.
REQUEST
| URI | /api/query/walmart/get/rid/{rid}? secretKey={secretKey} | {rid} – request id from the /api/query/add/ response |
| Example | /api/query/walmart/get/rid/58eb0033bfc238234367eb92?secretKey=xxxxxxxxxx | |