Get ASINS By URL

Amzpecty API can scan all ASINs of a particular Amazon search result URL through this API module.

ADD URL TO GET ASINS BY URL QUERY QUEUE

The request to add a URL to Get Asins By URL query queue. URL is an Amazon search result URL.

Warning: Amzpecty API can only get up to maximum of 2,400 Asins.

Limitations: Retrieved ASIN count may vary from the actual Amazon ASIN count due to various factors such as search location, dynamics of Amazon listings etc.

CREDIT DEDUCTION

1 (one) credit deduction after successful retrieval of 1 page Asin data.Asin count per page may vary.

REQUEST

URI	/api/query/getasinsbyurl?secretKey={secretKey}
Method	POST
POST Param	searchurl={url} where {url} – required – the target URL e.g https://www.amazon.com/s?k=funko&i=warehouse-deals
Http Header (optional)	AMZPECTY_CALLBACK_URL={Your callback URL}
Example	/api/query/getasinsbyurl

RESPONSE

Headers
MediaType	application/json
JSON Data

{
     "status": "OK",
     "responsefor": "getasinsbyurl",
     "allowed": 4992,
     "dailyAllowed": 4992,
     "messageId": null,
     "message": null,
     "data": null,
     "rid": "60f126e20cf24280ed03b000",
     "dateProcessed": null,
     "domain": null
}

Note: During callback, the rid can be used to link the callback data to the original request call.

GET ASINS BY URL QUERY CALLBACK JSON SAMPLE DATA

Headers
MediaType	application/json
JSON Data

{
  "status": "OK",
  "responsefor": "getasinsbyurl",
  "allowed": 4986,
  "dailyAllowed": 4986,
  "messageId": null,
  "message": null,
  "data": {
    "statusInt": 2,
    "status": "Completed",
    "searchUrl": " https://www.amazon.com/s?k=funko&i=warehouse-deals ",
    "expectedTotalAsins": 732,
    "actualAsinsRetrieved": 732,
    "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 BY URL QUERY CALLBACK RESPONSE JSON ATTRIBUTES

Attribute Name	Details
status	The status of the request.
responsefor	“getasinsbyurl” value for Get Asins By URL 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.statusInt	The search status in int form. 0 for “On Queue”, 1 for “Processing”, 2 for “Completed” or 3 for “Error”
data.status	The search status. “On Queue”, “Processing”, “Completed” or “Error”
data.actualAsinsRetrieved	The number of Asins retrieved. Maximum limit of 2,400 Asins only even if URL has more than 2,400 Asins. Note that actualAsinsRetrieved might not be equal to expectedTotalAsins for various reasons. Please refer to the status field for search state.
data.expectedTotalAsins	The total number of Asins this URL 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 ASINS BY URL RESULT BY REQUEST ID

The request to get the Get Asins By URL 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 status 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/ getasinsbyurl/rid/{rid}?secretKey={secretKey}	{rid} – request id from the /api/query/getasinsbyurl/ response
Example	/api/query/ getasinsbyurl/rid/60f12c1a0cf24280ed03c122?secretKey=XXXXXXXXXX

RESPONSE

See GET ASINS BY URL QUERY CALLBACK JSON SAMPLE DATA