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, refurbished, all ] {excludemoq} – optional – defaults to false if null/unspecified. valid values [true, false]. If true, Amzpecty will exclude moq lookup. |
| Http Header (optional) | AMZPECTY_CALLBACK_URL={Your callback URL} | |
| Example | /api/query/add/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx &condition=used&excludemoq=false | |
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": {
"queryAsin": "B01MYEYYYY",
"asin": "B01MYEYYEE",
"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,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}
ASIN SNAPSHOT QUERY CALLBACK RESPONSE JSON ATTRIBUTES
| Attribute Name | Details |
|---|---|
| status | The status of the request. |
| responsefor | “sellerinfo” value for Seller Info 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. |
| totalCreditsDeducted | This field indicates how many Amzpecty API credits were used to fulfill this request. |
| dateProcessed | The date the request was processed unix time format. |
| data.queryAsin | The ASIN specified in the ADD call. |
| data.asin | The ASIN of the product. The ASIN can be different than the ASIN specified in the ADD call. E.g. In case of Merged ASIN or Deleted ASIN. |
| data. itemName | The item name of the product. |
| data. brand | The brand name of the product. |
| data. salesRank | The maximum price of all offers of this product. |
| data. totalQty | The estimated Total Quantity of the product. |
| data. buyboxPrice | The current buybox price of the product excluding shipping. |
| data. buyboxSellerName | The current buybox seller name of the product. |
| data. buyboxSellerId | The seller id of the buybox seller. |
| data. buyboxItemCondition | The condition of the buy box item. |
| data. totalFBA | The total number of FBA sellers. |
| data. totalFBM | The total number of FBM 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. isAmazonSelling | Convenience flag if Amazon has an offer for this item. |
| data. isAmazonWarehouseSelling | Convenience flag if Amazon Warehouse has an offer for this item. |
| data. customerStarRating | Customer star rating. Sample value “4.5 out of 5 stars” |
| data. customerReview | Customer review count. Sample value “5,006 ratings” |
| data. totalOffers | The total number of offers of this product. |
| data.unavailable | If true, this flag indicates no offer for this listed product. |
| data.hasVariations | If true, this flag indicates that there are other variations of this product. |
| data.pageNotFound | If true, this flag indicates that the ASIN is currently not listed. |
| data.imageUrl | The URL of the image of the product. |
| data. offers[] | The list of offers of the product. |
| offers[n]. sellerName | The seller name of the seller offering the product. |
| offers[n]. sellerId | The seller id of the seller of this offer. |
| 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]. fba | Is offer FBA flag. |
| offers[n]. inventoryCount | The quantity available offered by the seller of this product. |
| offers[n]. conditionNote | The note on the product condition. (If any) |
| offers[n]. ratingStar | The star rating of this seller offering the product. |
| offers[n]. sellerRating | The rating of this seller offering the product. |
| offers[n]. prime | The flag indicating whether this offer is prime eligible. |
| offers[n]. sellerId | The seller id of the seller of this offer. |
| offers[n]. offerId | The id of this offer |
| 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) |
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 | |