1. Home
  2. Amzpecty Documentation
  3. Amzpecty API Specifications
  4. Seller Info API

Seller Info API

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
{
  "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
{
  "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,
  "productBrands": [
{
  name: "Funko",
  link: "https://www.amazon.com/s?i=merchant-items&me=A3Q6AVWKH7K575&rh=p_4%3AFunko&dc&qid=1646709577&ref=sr_nr_p_4_1"
},
{
  name: "Atria Books/Beyond Words",
  link: "https://www.amazon.com/s?i=merchant-items&me=A3Q6AVWKH7K575&rh=p_4%3AAtria+Books%2FBeyond+Words&dc&qid=1646709577&ref=sr_nr_p_4_2"
}
],
  "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"
}
SELLER INFO 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.sellerIdThe seller id.
data.sellerNameThe online name of the seller.
data.logoUrlThe url of the seller logo.
data.businessInfoMap 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.aboutAbout the seller.
data.feedbackStarList of key value pairs of product brands carried by the seller.
data.productCountThe number of products of the seller
data.productBrands[]List of key value pairs of product brands carried by the seller.
data.feedbackPositive30daysThe seller positive feedback for 30 days period.
data.feedbackPositive90daysThe seller positive feedback for 90 days period.
data.feedbackPositive12monthsThe seller positive feedback for 12 months period.
data.feedbackPositiveLifetimeThe seller positive feedback for lifetime period.
data.feedbackNeutral30daysThe seller neutral feedback for 30 days period.
data.feedbackNeutral90daysThe seller neutral feedback for 90 days period.
data.feedbackNeutral12monthsThe seller neutral feedback for 12 months period.
data.feedbackNeutralLifetimeThe seller neutral feedback for lifetime period.
data.feedbackNegative30daysThe seller negative feedback for 30 days period.
data.feedbackNegative90daysThe seller negative feedback for 90 days period.
data.feedbackNegative12monthsThe seller negative feedback for 12 months period.
data.feedbackNegativeLifetimeThe seller negative feedback for lifetime period.
data.feedbackCount30daysThe seller feedback count for 30 days period.
data.feedbackCount90daysThe seller feedback count for 90 days period.
data.feedbackCount12monthsThe seller feedback count for 12 months period.
data.feedbackCountLifetimeThe 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
{
  "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
{
  "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.40,
  "priceShipping": 0.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"
}
GET SELLER ASINS 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.sellerIdThe seller id.
data.searchStatusThe search status. “in-progress” or “completed”
data.completedAsinsThe 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.businessInfoMap of key value pairs e.g.
Business Name=9103-6152 Quebec Inc
Business Address=558A Hempstead Ave WEST TOWN New York 112233 US
data.totalAsinsThe total number of Asins this seller has.
data.asins[]The list of Asins this seller has.
asins[n].asinThe Asin of the item
asins[n].itemNameThe item name of the Asin
asins[n].priceThe displayed price of the Asin
asins[n].customerStarRatingThe customer star rating of the Asin
asins[n].customerReviewThe customer review count of the Asin
asins[n].linkUrlThe link of the Asin
asins[n].imageUrlThe 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
RESPONSE

See Get Seller Asins Query Callback JSON Sample Data

Was this article helpful to you? Yes No

How can we help?