ADD SELLER ID TO SELLER INFO QUERY QUEUE
The request to add a Seller Id to Seller Info query queue.
CREDIT DEDUCTION
1 (one) credit deduction after successful retrieval of data.
REQUEST
| URI | /api/query/seller/{SELLER ID}? domain={domain}&secretKey={secretKey} | {SELLER ID} – required – the Seller Id of the target seller {domain} – optional – defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list. |
| Http Header (optional) | AMZPECTY_CALLBACK_URL={Your callback URL} | |
| Example | /api/query/seller/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX | |
RESPONSE
| Headers | |
| MediaType | application/json |
| JSON Data |
JSON
{
"status": "OK",
"responsefor": "sellerinfo",
"allowed": 4992,
"dailyAllowed": 4992,
"messageId": null,
"message": null,
"data": null,
"rid": "60f126e20cf24280ed03be54",
"dateProcessed": null,
"domain": null
}SELLER INFO QUERY CALLBACK JSON SAMPLE DATA
| Headers | |
| MediaType | application/json |
| JSON Data |
JSON
{
"status": "OK",
"responsefor": "sellerinfo",
"allowed": 4986,
"dailyAllowed": 4986,
"messageId": null,
"message": null,
"data": {
"sellerId": "A3VHYG59GNVJVO",
"sellerName": "CMDStore",
"logoUrl": "https://images-na.ssl-images-amazon.com/images/I/419Udl8VRCL.png",
"businessInfo": {
"Business Name": "9103-6152 Quebec Inc",
"Business Address": " 3940 Griffith St Montreal QC H4T1A7 CA",
"other key": "other value"
},
"about": "CMDStore is committed to providing each customer with the highest standard of customer service.",
"feedbackStar": 4.5,
"productCount": 2000,
"feedbackPositive30days": 91,
"feedbackPositive90days": 95,
"feedbackPositive12months": 96,
"feedbackPositiveLifetime": 98,
"feedbackNeutral30days": 4,
"feedbackNeutral90days": 1,
"feedbackNeutral12months": 1,
"feedbackNeutralLifetime": 1,
"feedbackNegative30days": 4,
"feedbackNegative90days": 4,
"feedbackNegative12months": 3,
"feedbackNegativeLifetime": 1,
"feedbackCount30days": 23,
"feedbackCount90days": 75,
"feedbackCount12months": 357,
"feedbackCountLifetime": 13300
},
"rid": "60f12c1a0cf24280ed03be5e",
"dateProcessed": 1626418203388,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}SELLER INFO 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.sellerId | The seller id. |
| data.sellerName | The online name of the seller. |
| data.logoUrl | The url of the seller logo. |
| data.businessInfo | Map of key value pairs e.g. |
| Business Name=9103-6152 Quebec Inc | |
| Business Address=558A Hempstead Ave WEST TOWN New York 112233 US | |
| ( other_key = other_value ) | |
| data.about | About the seller. |
| data.feedbackStar | List of key value pairs of product brands carried by the seller. |
| data.productCount | The number of products of the seller |
| ** DEPRECATED 2/16/2024 ** data.productBrands[] | List of key value pairs of product brands carried by the seller. |
| data.feedbackPositive30days | The seller positive feedback for 30 days period. |
| data.feedbackPositive90days | The seller positive feedback for 90 days period. |
| data.feedbackPositive12months | The seller positive feedback for 12 months period. |
| data.feedbackPositiveLifetime | The seller positive feedback for lifetime period. |
| data.feedbackNeutral30days | The seller neutral feedback for 30 days period. |
| data.feedbackNeutral90days | The seller neutral feedback for 90 days period. |
| data.feedbackNeutral12months | The seller neutral feedback for 12 months period. |
| data.feedbackNeutralLifetime | The seller neutral feedback for lifetime period. |
| data.feedbackNegative30days | The seller negative feedback for 30 days period. |
| data.feedbackNegative90days | The seller negative feedback for 90 days period. |
| data.feedbackNegative12months | The seller negative feedback for 12 months period. |
| data.feedbackNegativeLifetime | The seller negative feedback for lifetime period. |
| data.feedbackCount30days | The seller feedback count for 30 days period. |
| data.feedbackCount90days | The seller feedback count for 90 days period. |
| data.feedbackCount12months | The seller feedback count for 12 months period. |
| data.feedbackCountLifetime | The seller feedback count for lifetime period. |
GET SELLER INFO RESULT BY REQUEST ID
The request to get the Seller Info result by Request Id (rid).
CREDIT DEDUCTION
0 (zero) credit deduction for the Get call.
REQUEST
| URI | /api/query/getsellerinfo/rid/{rid}?secretKey={secretKey} | {rid} – request id from the /api/query/estprofit/ response |
| Example | /api/query/ getsellerinfo/rid/60f12c1a0cf24280ed03c11d?secretKey=XXXXXXXXXX | |
RESPONSE
See Seller Info Query Callback JSON Sample Data
ADD SELLER ID TO GET SELLER ASINS QUERY QUEUE
The request to add a Seller Id to Get Get Seller Asins query queue.
Warning: Amzpecty API can only get up to maximum of 2,400 Asins.
CREDIT DEDUCTION
1 (one) credit deduction after successful retrieval of 1 page Asin data. Each page contaiAns maximum of 16 Asins.
REQUEST
| URI | /api/query/seller/getasins/{SELLER ID}? domain={domain}&secretKey={secretKey} | {SELLER ID} – required – the Seller Id of the target seller {domain} – optional – defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list. |
| Http Header (optional) | AMZPECTY_CALLBACK_URL={Your callback URL} | |
| Example | /api/query/seller/getasins/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX | |
RESPONSE
| Headers | |
| MediaType | application/json |
| JSON Data |
JSON
{
"status": "OK",
"responsefor": "sellerasins",
"allowed": 4992,
"dailyAllowed": 4992,
"messageId": null,
"message": null,
"data": null,
"rid": "60f126e20cf24280ed03b000",
"dateProcessed": null,
"domain": null
}GET SELLER ASINS QUERY CALLBACK JSON SAMPLE DATA
| Headers | |
| MediaType | application/json |
| JSON Data |
JSON
{
"status": "OK",
"responsefor": "sellerasins",
"allowed": 4986,
"dailyAllowed": 4986,
"messageId": null,
"message": null,
"data": {
"sellerId": "A3VHYG59GNVJVO",
"status": "completed",
"completedAsins": 2,
"totalAsins": 2,
"asins": [
{
"asin": "B07JLCLVRJ",
"itemName": "Funko PoP! MArvel",
"price": 9.99,
"customerStarRating": "4.5 out of 5 stars",
"customerReview": "5,006 ratings",
"linkUrl": "http://www.amazon.com/gp/product/B07JLCLVRJ/ref=silver_xx_cont_revecalc",
"imageUrl": "https://m.media-amazon.com/images/I/61Y6N4hBjDL._SL120_.jpg",
"otherDetails": [
"Get it as soon as Tue, Mar 29",
"$3.99 shipping",
"Only 1 left in stock - order soon."
]
},
{
"asin": "B08XMY2DWM",
"itemName": "Party House Masters of The Universe Mini Figurines Cake Toppers ",
"price": 7.4,
"priceShipping": 0,
"inventoryWarning": "",
"customerStarRating": "5 out of 5 stars",
"customerReview": "1,105 ratings",
"linkUrl": "http://www.amazon.com/gp/product/B08XMY2DWM/ref=silver_xx_cont_revecalc",
"imageUrl": "https://m.media-amazon.com/images/I/61Y6N4hBjDL._SL120_.jpg",
"otherDetails": [
"Get it as soon as Tue, Mar 29",
"$2.99 shipping",
"Only 10 left in stock - order soon."
]
}
]
},
"rid": "60f12c1a0cf24280ed03be5e",
"dateProcessed": 1626418203388,
"domain": "www.amazon.com"
"totalCreditsDeducted": 1
}GET SELLER ASINS 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.sellerId | The seller id. |
| data.searchStatus | The search status. “in-progress” or “completed” |
| data.completedAsins | The number of Asins retrieved. Maximum limit of 2,400 Asins only even if seller has more than 2,400 Asins. Note that totalAsins might not be equal to completedAsins for various reasons. Please refer to the searchStatus field for search state. |
| data.businessInfo | Map of key value pairs e.g. |
| Business Name=9103-6152 Quebec Inc | |
| Business Address=558A Hempstead Ave WEST TOWN New York 112233 US | |
| data.totalAsins | The total number of Asins this seller has. |
| data.asins[] | The list of Asins this seller has. |
| asins[n].asin | The Asin of the item |
| asins[n].itemName | The item name of the Asin |
| asins[n].price | The displayed price of the Asin |
| asins[n].customerStarRating | The customer star rating of the Asin |
| asins[n].customerReview | The customer review count of the Asin |
| asins[n].linkUrl | The link of the Asin |
| asins[n].imageUrl | The image url of the Asin |
| asins[n].otherDetails[n] | List of other details such as Shipping Information, Shipping Fees, Stock Warning etc. |
GET SELLER ASINS RESULT BY REQUEST ID
The request to get the Seller Asins result by Request Id (rid).
Note that you can call this to retrieve results data even if Amzpecty is still looking up data and not 100% complete. You can refer to the searchStatus field for search status.
Note: Please avoid making very short interval successive calls. Every at least 30 seconds is our recommended call interval.
CREDIT DEDUCTION
0 (zero) credit deduction for the Get call.
REQUEST
| URI | /api/query/seller/getasins/{SELLER ID}? domain={domain}&secretKey={secretKey} | {SELLER ID} – required – the Seller Id of the target seller {domain} – optional – defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list. |
| Example | /api/query/getsellerasin/rid/60f12c1a0cf24280ed03c11d?secretKey=XXXXXXXXXX | |
