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
MediaTypeapplication/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
MediaTypeapplication/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,
            "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
MediaTypeapplication/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
MediaTypeapplication/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.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 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.
totalCreditsDeductedThis field indicates how many Amzpecty API credits were used to fulfill this request.
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

Our goal is to assist Amazon sellers reach new heights.

Automate the most tedious tasks in your Amazon business so you can focus on what really matters—growing profits! Install Amzpecty Chrome Extension from the Chrome Web Store NOW.

Get Started Now For Premium Subscribers -> Login Here