1. Home
  2. Docs
  3. Amzpecty Documentation
  4. Amzpecty API Specifications
  5. Product ID to ASIN API

Product ID to ASIN API

ADD UPC/EAN/ISBN TO MATCH PRODUCT ID TO ASIN QUERY QUEUE

The request to add a UPC/EAN/ ISBN to Match Product Id to ASIN query queue.

CREDIT DEDUCTION

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

REQUEST
URI /api/query/matchasins/{productId}?domain={domain}&secretKey={secretKey}

Add the url parameter below for expanded results.

&expanded=true
{ productId } – value can be UPC, EAN or ISBN {domain} – optional – the target Amazon domain. 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/matchasins/889698281140?domain=www.amazon.com&secretKey=xxxxxxx&expanded=true
RESPONSE
Headers
MediaType application/json
JSON Data
JSON
{
    "status": "OK",
    "responsefor": "matchasins",
    "allowed": 4100,
    "dailyAllowed": null,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60d99426e4b0dd7aa946dcc3",
    "dateProcessed": null
}

GET MATCHED ASIN BY PRODUCT ID

The request to get the matched ASIN(s) by Product Id .

CREDIT DEDUCTION

0 (zero) credit deduction for the Get call.

REQUEST
URI /api/query/getmatchasins/productid/{productId}?domain={domain}&secretKey={secretKey} { productId } – value can be UPC, EAN or ISBN

{domain} – optional – the target Amazon domain. Defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list.
Example /api/query/getmatchasins/productid/889698281140?domain=www.amazon.com&secretKey=xxxxxxx
RESPONSE (NORMAL)
Headers
MediaType application/json
JSON Data
JSON
{
    "status": "OK",
    "responsefor": "matchasins",
    "allowed": 4099,
    "dailyAllowed": null,
    "messageId": null,
    "message": null,
    "data": {
        "productId": "889698281140",
        "totalMatch": 2,
        "match": [
            {
                "asin": "B07JLCLVRJ",
                "itemName": "Funko PoP! MArvel",
                "link": "http://www.amazon.com/gp/product/B07JLCLVRJ/ref=silver_xx_cont_revecalc",
                "imageUrl": "https://m.media-amazon.com/images/I/61Y6N4hBjDL._SL120_.jpg"
            },
            {
                "asin": "B0822D5J3H",
                "itemName": "Funko PoP! Marvel Avengers 3: Infinity War - Infinity Stones Thanos Chrome Funko Pop! ",
                "link": "http://www.amazon.com/gp/product/B0822D5J3H/ref=silver_xx_cont_revecalc",
                "imageUrl": "https://m.media-amazon.com/images/I/61cjGuIskKL._SL120_.jpg"
            }
        ]
    },
    "rid": "60d97a7ae4b0257198902e55",
    "dateProcessed": 1626840063541,
    "domain": "www.amazon.com",
    "totalCreditsDeducted": 1
}
RESPONSE (WHEN EXPANDED IS ENABLED)
Headers
MediaType application/json
JSON Data
JSON
{
  "status": "OK",
  "responsefor": "matchasins",
  "allowed": 4099,
  "dailyAllowed": null,
  "messageId": null,
  "message": null,
  "data": {
    "productId": "3401575390447",
    "totalMatch": 1,
    "match": [
      {
        "asin": "B0036SFTK4",
        "itemName": "Bioderma - Sensibio - H2O Micellar Water - Makeup Remover Cleanser - Face Cleanser for Sensitive Skin",
        "link": "https://www.amazon.com/gp/product/B0036SFTK4/ref=xx_dp_cont_revecalc",
        "imageUrl": "https://m.media-amazon.com/images/I/31zvmrJnssL._SL120_.jpg",
        "offerCount": 4,
        "thumbStringUrl": "https://m.media-amazon.com/images/I/31zvmrJnssL._SL120_SL80_.jpg",
        "weight": 0.7099,
        "weightUnit": "pounds",
        "dimensionLength": 2.2,
        "dimensionWidth": 2.24,
        "dimensionHeight": 5.67,
        "dimensionUnit": "inches",
        "customerReviewsCount": 41215,
        "customerReviewsRating": "4.8 out of 5 stars",
        "customerReviewsRatingfullStarCount": 5,
        "customerReviewsRatingValue": 4.8,
        "sellerName": "Michele Clark",
        "sellerShipsFrom": "Amazon",
        "price": 12.99,
        "shippingPrice": 0,
        "salesRank": 121,
        "salesRankContextName": "Beauty & Personal Care"
      }
    ]
  },
  "rid": "60d97a7ae4b0257198902e55",
  "dateProcessed": 1626840063541,
  "domain": "www.amazon.com",
  "totalCreditsDeducted": 1
}

GET MATCHED ASIN BY RID

The request to get the matched ASIN(s) by Request Id (RID).

CREDIT DEDUCTION

0 (zero) credit deduction for the Get call.

REQUEST
URI /api/query/getmatchasins/rid/{rid}?domain={domain}&secretKey={secretKey} { rid } – request id from the add response {domain} – optional – the target Amazon domain. Defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list.
Example /api/query/getmatchasins/rid/60d99426e4b0dd7aa946dcc3?domain=www.amazon.com&secretKey=xxxxxxx
RESPONSE

See Get Matched Asin by Product Id Response Data

Was this article helpful to you? Yes No
How can we help?