1. Home
  2. Docs
  3. Amzpecty Documentation
  4. Private: Walmart API Specifications
  5. Walmart Snapshot API

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
JSON
{
    "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
JSON
{
  "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 NameDetails
statusThe status of the request. “OK” for good results
responsefor“walmartsnapshot” value for Walmart Snapshot query result.
allowedThe current allowed request count. Resets monthly.
dailyAllowedThe current allowed daily request count. Resets daily.
messageIdThe id of the message (if any) .
messageThe actual message (if any). Please refer to Error Messages.
ridThe request id. This can be used in the Get query as a key.
domainThe corresponding Amazon domain for the Seller.
dateProcessedThe date the request was processed unix time format.
data.itemIdThe Item Id of the product.
data. itemNameThe item name of the product.
data. brandThe brand name of the product.
data.averageRatingThe average star rating of this item.
data.numberOfReviewsThe number of reviews of this item.
data. totalQtyThe estimated Total Quantity of the product.
data. buyboxPriceThe buy box price.
data. buyboxSellerNameThe buy box seller name.
data. buyboxSellerIdThe buy box seller id.
data. buyboxOfferListingIdThe buy box offer listing id.
data. buyboxArriveStartThe buy box arrival/delivery start date.
data. totalProSellerThe total count of Pro sellers
data. maxPriceThe maximum price of all offers of this product.
data. minPriceThe minimum price of all offers of this product.
data. avgPriceThe average price of all offers of this product.
data. totalOffersThe total number of offers of this product.
data. offers[]The list of offers of the product.
offers[n]. sellerNameThe seller name of the seller offering the product.
offers[n]. conditionThe condition of the product.
offers[n]. priceThe price of the product.
offers[n]. priceShippingThe shipping fee of this product offer.
offers[n]. priceTotalThe sum of price and shipping of this product offer.
offers[n]. inventoryCountThe quantity available offered by the seller of this product.
offers[n]. moqThe minimum order quantity flag of this offer. (If seller imposes MOQ)
offers[n]. moqvalueThe actual minimum order quantity value of this offer. (If seller imposes MOQ)
offers[n].proSellerThe Pro seller flag. “true“ or “false“
offers[n].sellerIdThe seller id of the seller of this offer.
offers[n].offerListingIdThe offer listing id.
offers[n].arriveStartThe arrival/delivery start date of this offer.
offers[n].availabilityThe availability of this offer. “ONLINE_AND_STORE”, “IN_STOCK” etc.
offers[n].publishedThe 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
RESPONSE

See Walmart Snapshot Query Callback JSON Sample Data

Was this article helpful to you? Yes No
How can we help?