1. Home
  2. Amzpecty Documentation
  3. Amzpecty API Specifications
  4. ASIN Snapshot API

ASIN Snapshot API

ADD ASIN/ISBN TO ASIN SNAPSHOT QUERY QUEUE

The request to add an ASIN/ISBN to Asin Snapshot query queue.

CREDIT DEDUCTION

1 (one) credit deduction after successful retrieval of data.

REQUEST
URI /api/query/add/{ASIN/ISBN}?domain={domain}&secretKey={secretKey}&condition={condition} {ASIN/ISBN} – required – the ASIN or ISBN to add to tracking list {domain} – optional – defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list. {condition} – optional – defaults to new if null/unspecified valid values [ new, used, collectible ]
Http Header (optional) AMZPECTY_CALLBACK_URL={Your callback URL}
Example /api/query/add/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx &condition=used
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.

ASIN SNAPSHOT QUERY CALLBACK

ASIN 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
MediaType application/json
ASIN SNAPSHOT QUERY CALLBACK JSON SAMPLE DATA
Headers
MediaType application/json
JSON Data
{
  "status": "OK",
  "responsefor": "asinsnapshot",
  "allowed": 4992,
  "dailyAllowed": 500,
  "messageId": null,
  "message": null,
  "data": {
  "asin": "B01MYEYYYY",
  "itemName": "Nest 9750016 T3016US Thermostat Black",
  "brand": "by Nest",
  "salesRank": 11346,
  "totalQty": 150,
  "buyboxPrice": "237.15",
  "buyboxSellerName": "JJJ SELLER",
  "buyboxSellerId": "AAW8R82WBLFL9",
  "buyboxItemCondition": "New","totalFBA": 6,
  "totalFBM": 7,
  "maxPrice": 599,
  "minPrice": 237.79,
  "avgPrice": 293.05,
  "isAmazonSelling": false,
  "isAmazonWarehouseSelling": false,
  "customerStarRating" : "4.5 out of 5 stars",
  "customerReview" : "5,006 ratings",
  "totalOffers": 1,
  "pageNotFound": false,
  "hasVariations": true,
  "unavailable": false,
  "offers": [
{
  "sellerName": "cables4computer",
  "condition": "New",
  "price": 237.79,
  "priceShipping": 0,
  "priceTotal": 237.79,
  "fba": false,
  "inventoryCount": 11,
  "conditionNote": "",
  "ratingStar": 4.5,
  "sellerRating": "89% positive over the past 12 months. (13,223 total ratings)",
  "prime": false,
  "sellerId": "A3VZC5G7U3OWU4",
  "offerId": "8pwpOXydEI1znRNLYpU",
  "moq": false,
  "moqvalue": 0
}
]
},
  "rid": "5d6e0b63e4b0e29d7d7d232c",
  "dateProcessed": 1567492992552
}
ASIN SNAPSHOT QUERY CALLBACK RESPONSE JSON ATTRIBUTES
Attribute NameDetails
statusThe status of the request.
responsefor“sellerinfo” value for Seller Info 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.asinThe ASIN of the product.
data. itemNameThe item name of the product.
data. brandThe brand name of the product.
data. salesRankThe maximum price of all offers of this product.
data. totalQtyThe estimated Total Quantity of the product.
data. buyboxPriceThe current buybox price of the product excluding shipping.
data. buyboxSellerNameThe current buybox seller name of the product.
data. buyboxSellerIdThe seller id of the buybox seller.
data. buyboxItemConditionThe condition of the buy box item.
data. totalFBAThe total number of FBA sellers.
data. totalFBMThe total number of FBM 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. isAmazonSellingConvenience flag if Amazon has an offer for this item.
data. isAmazonWarehouseSellingConvenience flag if Amazon Warehouse has an offer for this item.
data. customerStarRatingCustomer star rating. Sample value “4.5 out of 5 stars”
data. customerReviewCustomer review count. Sample value “5,006 ratings”
data. totalOffersThe total number of offers of this product.
data.unavailableIf true, this flag indicates no offer for this listed product.
data.hasVariationsIf true, this flag indicates that there are other variations of this product.
data.pageNotFoundIf true, this flag indicates that the ASIN is currently not listed.
data. offers[]The list of offers of the product.
offers[n]. sellerNameThe seller name of the seller offering the product.
offers[n]. sellerIdThe seller id of the seller of this offer.
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]. fbaIs offer FBA flag.
offers[n]. inventoryCountThe quantity available offered by the seller of this product.
offers[n]. conditionNoteThe note on the product condition. (If any)
offers[n]. ratingStarThe star rating of this seller offering the product.
offers[n]. sellerRatingThe rating of this seller offering the product.
offers[n]. primeThe flag indicating whether this offer is prime eligible.
offers[n]. sellerIdThe seller id of the seller of this offer.
offers[n]. offerIdThe id of this offer
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)

GET ASIN SNAPSHOT RESULT BY ASIN/ISBN

The request to get the latest Asin Snapshot result by ASIN/ISBN.

CREDIT DEDUCTION

0 (zero) credit deduction for the Get call.

REQUEST
URI /api/query/get/asin/{ASIN/ISBN}?domain={domain}&secretKey={secretKey} {ASIN/ISBN} – the ASIN to get most recent tracking list {domain} – optional – defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list.
Example /api/query/get/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx
RESPONSE

See Asin Snapshot Query Callback JSON Sample Data

GET ASIN SNAPSHOT RESULT BY REQUEST ID

The request to get the latest Asin Snapshot result by Request Id (rid).

CREDIT DEDUCTION

0 (zero) credit deduction for the Get call.

REQUEST
URI {rid} – request id from the /api/query/add/ response {domain} – optional – defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list.
Example /api/query/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx
RESPONSE

See Asin Snapshot Query Callback JSON Sample Data

GET ASIN SNAPSHOT RESULT BY REQUEST ID

The request to get the latest Asin Snapshot result by Request Id (rid).

CREDIT DEDUCTION

0 (zero) credit deduction for the Get call.

REQUEST
URI {rid} – request id from the /api/query/add/ response {domain} – optional – defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list.
Example /api/query/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx
RESPONSE

See Asin Snapshot Query Callback JSON Sample Data

Was this article helpful to you? Yes No

How can we help?