Amzpecty API は、この API モジュールを通じて、特定の Amazon 検索結果 URL のすべての ASIN をスキャンできます。
URL クエリキューで ASINS を取得するには URL を追加してください
URL を Get Asins By URL クエリ キューに追加するリクエスト。 URLはAmazonの検索結果URLです。
警告: Amzpecty API は最大 2,400 Asins までしか取得できません。
制限事項: 検索場所、Amazon 出品の動態などのさまざまな要因により、取得された ASIN 数は実際の Amazon ASIN 数と異なる場合があります。
クレジット控除
1 ページの Asin データの取得に成功した後、1 クレジットが差し引かれます。ページごとの Asin 数は異なる場合があります。
要求
| URI | /api/query/getasinsbyurl?secretKey={secretKey} | |
| 方法 | POST | |
| POSTパラメータ | searchurl={url} ここで、{url} – 必須 – ターゲット URL 例: https://www.amazon.com/s?k=funko&i=warehouse-deals | |
| HTTP ヘッダー (オプション) | AMZPECTY_CALLBACK_URL={コールバック URL} | |
| 例 | /api/query/getasinsbyurl | |
応答
| ヘッダ | |
| メディアタイプ | アプリケーション/ json |
| JSONデータ |
JSONの
{
"status": "OK",
"responsefor": "getasinsbyurl",
"allowed": 4992,
"dailyAllowed": 4992,
"messageId": null,
"message": null,
"data": null,
"rid": "60f126e20cf24280ed03b000",
"dateProcessed": null,
"domain": null
}注意: コールバック中に、rid を使用してコールバック データを元のリクエスト呼び出しにリンクできます。
URL クエリ コールバックによる ASINS の取得 JSON サンプル データ
| ヘッダ | |
| メディアタイプ | アプリケーション/ json |
| JSONデータ |
JSONの
{
"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
}URL クエリ コールバック レスポンス JSON 属性によって販売者 ASINS を取得する
| 属性名 | 詳細 |
|---|---|
| status | リクエストのステータス。 |
| 応答のための | Get Asins By URL クエリ結果の「getasinsbyurl」値。 |
| 許可されて | 現在許可されているリクエスト数。 毎月リセットされます。 |
| 毎日許可 | 現在許可されている XNUMX 日あたりのリクエスト数。 毎日リセットされます。 |
| メッセージID | メッセージの ID (存在する場合)。 |
| メッセージ | 実際のメッセージ (存在する場合)。 エラーメッセージを参照してください。 |
| 取り除く | リクエストID。 これは、Get クエリでキーとして使用できます。 |
| ドメイン | 販売者に対応する Amazon ドメイン。 |
| 差し引かれる合計クレジット数 | このフィールドは、このリクエストを満たすために使用された Amzpecty API クレジットの数を示します。 |
| 処理された日付 | リクエストが処理された日付 (Unix 時間形式)。 |
| data.sellerId | 販売者ID。 |
| data.statusInt | int 形式の検索ステータス。 0 は「キュー中」、1 は「処理中」、2 は「完了」、または 3 は「エラー」 |
| データのステータス | 検索ステータス。 「キュー中」、「処理中」、「完了」または「エラー」 |
| data.actualAsinsRetrieved | 取得された Asin の数。 URL に 2,400 Asin を超える場合でも、最大制限は 2,400 Asins のみです。 ご了承ください 実際のAsinsRetrieved と等しくないかもしれない 予想される合計Asins さまざまな理由から。 を参照してください。タタス 検索状態のフィールド。 |
| data.expectedTotalAsins | この URL に含まれる Asin の総数。 |
| データ.asins[] | この出品者が所有する Asins のリスト。 |
| asins[n].asin | アイテムのアシン |
| asins[n].アイテム名 | アシンのアイテム名 |
| asins[n].price | アシンの表示価格 |
| asins[n].customerStarRating | Asin の顧客の星評価 |
| asins[n].customerReview | Asinのカスタマーレビュー数 |
| asins[n].linkUrl | アシンのリンク |
| asins[n].imageUrl | Asinの画像URL |
| asins[n].otherDetails[n] | 配送情報、送料、在庫警告などのその他の詳細のリスト。 |
URL による ASINS の取得 リクエスト ID による結果
リクエスト ID による Get Asins By URL 結果を取得するリクエスト (取り除く).
Amzpecty がまだデータを検索中であり、100% 完了していない場合でも、これを呼び出して結果データを取得できることに注意してください。 を参照できます。タタス 検索ステータスのフィールド。
注: 非常に短い間隔で連続して呼び出しを行うことは避けてください。 推奨される呼び出し間隔は、少なくとも 30 秒ごとです。
クレジット控除
Get 呼び出しに対する 0 (ゼロ) クレジット控除。
要求
| URI | /api/query/getasinsbyurl/rid/{rid}?secretKey={secretKey} | {rid} – /api/query/getasinsbyurl/ 応答からのリクエスト ID |
| 例 | /api/query/ getasinsbyurl/rid/60f12c1a0cf24280ed03c122?secretKey=XXXXXXXXXX | |
