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 | |
