# 依 id 取得 Amazon ASIN 結果
**API:** Data API
**Endpoint:** `GET /v1/beta/dataforseo/merchant/amazon/asin/task_get/advanced/{id}`
**Tags:** DataForSEO
一個 Amazon 商品頁，來自 `post_dataforseo_merchant_amazon_asin_submit` 排入佇列的任務。傳回 `asin`、`se_domain`、`location_code`、`language_code`、`check_url`、`datetime`、`item_types`、`items_count` 與 `items`，每項包含 `title`、`details`、`image_url`、`author`、`data_asin`、`parent_asin` 與 `product_asins`——最後一個欄位是變體家族，可用來尋找其他尺寸或顏色。採用 DataForSEO 的信封結構：資料位於 `tasks[0].result`，結果狀態位於 `tasks[0].status_code`——被拒絕的請求仍會傳回 HTTP 200。僅在解析結果缺少你能明確指出的內容時才使用。
### 計費參考
- 計量方式：依回報的回應成本計量。
- 參考請求估算：0.012 美元。
- 參考客戶倍率：1.0。不得對已結算的客戶金額再次套用。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
## Base URL
- `https://openapi.felo.ai`
## Authentication
- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)
## Parameters
| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `id` | path | yes | string | 任務識別碼
我們系統中 UUID 格式的唯一任務識別碼
可在 30 天內隨時使用它請求任務結果 |
## Responses
### 200 — 操作成功
Headers:
- `X-Request-Id` (string) — 聯絡 Felo 支援時需提供的請求識別碼。
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResponseInfo"
}
]
}
```
### 400 — 無法處理該要求。請檢查請求參數。
### 401 — 需要有效的 Felo API 金鑰。
### 402 — 由於未符合計費要求，要求無法繼續。
### 403 — 該帳戶無權執行此操作。
### 429 — 已達到要求或支出上限。
### 502 — 服務無法完成該要求。
### 503 — API 或計費服務暫時無法使用。
### 504 — 服務在處理要求時逾時。
### default — 錯誤回應；上游透傳回應可能採用供應商格式
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_AiModeImagesElementInfo
`#/components/schemas/Response36Afe1097B20_AiModeImagesElementInfo`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"alt": {
"type": [
"string",
"null"
],
"description": "圖片的 alt 標籤"
},
"url": {
"type": [
"string",
"null"
],
"description": "相關 URL"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "圖片的 URL
指向原始資源或 DataForSEO 儲存空間中該圖片的 URL（原始來源不可用時）"
}
}
}
```
### Response36Afe1097B20_AmazonApplicableVouchersItem
`#/components/schemas/Response36Afe1097B20_AmazonApplicableVouchersItem`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"text": {
"type": [
"string",
"null"
],
"description": "優惠券的文字"
},
"fixed_discount": {
"type": [
"number",
"null"
],
"description": "固定折扣的值"
},
"fixed_discount_currency": {
"type": [
"string",
"null"
],
"description": "固定折扣的貨幣代碼"
},
"percentage_discount": {
"type": [
"number",
"null"
],
"description": "百分比折扣的值
若折扣為固定折扣，則該值為 null"
},
"important_details": {
"type": [
"string",
"null"
],
"description": "折扣券條款的重要細節"
}
}
}
```
### Response36Afe1097B20_AmazonProductInfo
`#/components/schemas/Response36Afe1097B20_AmazonProductInfo`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"rank_group": {
"type": [
"integer",
"null"
],
"description": "具有相同 type 值的元素群組內的位置
不同 type 值的元素位置不計入 rank_group"
},
"rank_absolute": {
"type": [
"integer",
"null"
],
"description": " 絕對排名
回應陣列中所有元素中的絕對位置"
},
"position": {
"type": [
"string",
"null"
],
"description": "元素在 Amazon SERP 中的對齊方式
可能的值：
left、right"
},
"xpath": {
"type": [
"string",
"null"
],
"description": "元素的 XPath"
},
"title": {
"type": [
"string",
"null"
],
"description": "商品標題"
},
"details": {
"type": [
"string",
"null"
],
"description": "商品規格與其他詳細資料"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "商品圖片的 URL"
},
"author": {
"type": [
"string",
"null"
],
"description": "商品品牌名稱"
},
"data_asin": {
"type": [
"string",
"null"
],
"description": "POST 陣列中收到的商品 ASIN"
},
"parent_asin": {
"type": [
"string",
"null"
],
"description": "商品的父 ASIN"
},
"product_asins": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "找到的所有商品變體的 ASIN"
},
"price_from": {
"type": [
"number",
"null"
],
"description": "商品價格區間的下限
範例：
49.98"
},
"price_to": {
"type": [
"number",
"null"
],
"description": "商品價格區間的上限
範例：
384.99"
},
"percentage_discount": {
"type": [
"string",
"null"
],
"description": "折扣百分比數值"
},
"currency": {
"type": [
"string",
"null"
],
"description": "ISO 格式的貨幣
範例：
USD"
},
"is_amazon_choice": {
"type": [
"boolean",
"null"
],
"description": "「Amazon's choice」標籤
若值為 true，則該商品帶有「Amazon's choice」標籤"
},
"rating": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_RatingElement"
}
],
"description": "商品評分資訊"
},
"is_newer_model_available": {
"type": [
"boolean",
"null"
],
"description": "表示該商品是否有較新的型號"
},
"is_prime_video": {
"type": [
"boolean",
"null"
],
"description": "表示商品是否帶有 Amazon Prime Video 標籤
若為 true，則指定商品屬於 Amazon Prime Video 服務的一部分"
},
"applicable_vouchers": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AmazonApplicableVouchersItem"
}
]
},
"description": "包含適用優惠券資訊的物件陣列"
},
"newer_model": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_NewerModel"
}
],
"description": "有關該商品較新型號的資訊"
},
"categories": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_Categories"
}
]
},
"description": "包含相關商品類別"
},
"product_information": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseMerchantAmazonProductInformationElementItem"
}
]
},
"description": "包含相關商品資訊"
},
"product_images_list": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "包含顯示於主圖左側的商品全部圖片 URL"
},
"product_videos_list": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "包含顯示於主影片右側的商品全部影片 URL"
},
"description": {
"type": [
"string",
"null"
],
"description": "包含商品描述"
},
"is_available": {
"type": [
"boolean",
"null"
],
"description": "表示商品是否可訂購
若值為 true，則該商品可以訂購"
},
"top_local_reviews": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AmazonReviewItem"
}
]
},
"description": "包含來自目標地點的熱門評論的物件陣列"
},
"top_global_reviews": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AmazonReviewItem"
}
]
},
"description": "包含來自世界各地的熱門評論的物件陣列"
}
}
}
```
### Response36Afe1097B20_AmazonReviewItem
`#/components/schemas/Response36Afe1097B20_AmazonReviewItem`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"rank_group": {
"type": [
"integer",
"null"
],
"description": "具有相同 type 值的元素群組內的位置
不同 type 值的元素位置不計入 rank_group"
},
"rank_absolute": {
"type": [
"integer",
"null"
],
"description": "所有列出評論中的絕對排名
清單中所有評論的絕對位置"
},
"position": {
"type": [
"string",
"null"
],
"description": "評論在 SERP 中的對齊方式
可為下列值：right"
},
"xpath": {
"type": [
"string",
"null"
],
"description": "元素的 XPath"
},
"verified": {
"type": [
"boolean",
"null"
],
"description": "表示評論是否帶有 “Verified Purchase” 標記"
},
"subtitle": {
"type": [
"string",
"null"
],
"description": "評論的副標題"
},
"helpful_votes": {
"type": [
"string",
"null"
],
"description": "有幫助票數
點擊評論文字下方「Helpful」按鈕的使用者數"
},
"images": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AiModeImagesElementInfo"
}
]
},
"description": "評論者提交的商品圖片"
},
"videos": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_VideoElement"
}
]
},
"description": "評論者提交的商品影片"
},
"user_profile": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_UserProfileInfo"
}
],
"description": "評論者的使用者個人檔案"
},
"title": {
"type": [
"string",
"null"
],
"description": "評論標題"
},
"url": {
"type": [
"string",
"null"
]
},
"review_text": {
"type": [
"string",
"null"
],
"description": "評論內容"
},
"publication_date": {
"type": [
"string",
"null"
],
"description": "評論發布的日期與時間
UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；
範例：
2019-11-15 12:57:46 +00:00"
},
"rating": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo"
}
],
"description": "評論者提交的評分"
}
}
}
```
### Response36Afe1097B20_BaseMerchantAmazonProductInformationElementItem
`#/components/schemas/Response36Afe1097B20_BaseMerchantAmazonProductInformationElementItem`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"section_name": {
"type": [
"string",
"null"
],
"description": "contents 中指定之產品資訊相關區段名稱"
}
},
"additionalProperties": false,
"discriminator": {
"propertyName": "type",
"mapping": {
"product_information_details_item": "#/components/schemas/Response36Afe1097B20_ProductInformationProductInformationDetailsItem",
"product_information_text_item": "#/components/schemas/Response36Afe1097B20_ProductInformationProductInformationTextItem",
"product_information_extended_item": "#/components/schemas/Response36Afe1097B20_ProductInformationProductInformationExtendedItem"
}
}
}
```
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "API 的目前版本"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "一般狀態碼\n完整回應碼清單請見此處"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "一般資訊訊息\n完整的一般資訊訊息清單請見此處"
},
"time": {
"type": [
"string",
"null"
],
"description": "總執行時間，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任務總費用，美元",
"format": "double"
},
"tasks_count": {
"type": [
"integer",
"null"
],
"description": "tasks 陣列中的任務數",
"format": "int64"
},
"tasks_error": {
"type": [
"integer",
"null"
],
"description": "tasks 陣列中傳回錯誤的任務數",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseTaskInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`
```json
{
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "任務識別碼\n我們系統中 UUID 格式的唯一任務識別碼"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "任務的狀態碼\n由 DataForSEO 產生，範圍如下：10000-60000\n完整回應碼清單請見此處"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "任務的資訊訊息\n完整的一般資訊訊息清單請見此處"
},
"time": {
"type": [
"string",
"null"
],
"description": "執行時間，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任務總費用，美元",
"format": "double"
},
"result_count": {
"type": [
"integer",
"null"
],
"description": "result 陣列中的元素數",
"format": "int64"
},
"path": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "URL 路徑"
},
"data": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"object",
"null"
]
},
"description": "包含你在 POST 請求中指定的相同參數"
}
}
}
```
### Response36Afe1097B20_Categories
`#/components/schemas/Response36Afe1097B20_Categories`
```json
{
"type": "object",
"properties": {
"category": {
"type": [
"string",
"null"
],
"description": "商品類別名稱"
},
"url": {
"type": [
"string",
"null"
],
"description": "商品類別 URL
表示Amazon 上的瀏覽路徑，其中包含唯一的瀏覽節點 ID（Amazon 上的商品類別 ID）"
}
}
}
```
### Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResponseInfo
`#/components/schemas/Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResponseInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedTaskInfo"
}
]
},
"description": "任務陣列"
}
}
}
]
}
```
### Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResultInfo
`#/components/schemas/Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResultInfo`
```json
{
"type": "object",
"properties": {
"asin": {
"type": [
"string",
"null"
],
"description": "POST 陣列中收到的 ASIN
POST 陣列中收到的 Amazon 唯一商品識別碼（ASIN）
在這篇說明中心指南中進一步瞭解此識別碼"
},
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"se_domain": {
"type": [
"string",
"null"
],
"description": "POST 陣列中的 Amazon 網域"
},
"location_code": {
"type": [
"integer",
"null"
],
"description": "POST 陣列中的位置代碼"
},
"language_code": {
"type": [
"string",
"null"
],
"description": "POST 陣列中的語言代碼"
},
"check_url": {
"type": [
"string",
"null"
],
"description": "Amazon 結果的直接 URL
你可以用它來確認我們提供的結果準確無誤"
},
"datetime": {
"type": [
"string",
"null"
],
"description": "收到結果的日期與時間
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：
2019-11-15 12:57:46 +00:00"
},
"item_types": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "Amazon 上找到的搜尋結果類型
包含傳回的 SERP 中找到的所有搜尋結果（items）類型
可能的項目類型：
amazon_product_info"
},
"items_count": {
"type": [
"integer",
"null"
],
"description": "items 陣列中傳回的結果數",
"format": "int64"
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AmazonProductInfo"
}
]
},
"description": "Amazon 商品資訊項目"
}
}
}
```
### Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedTaskInfo
`#/components/schemas/Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_MerchantAmazonAsinTaskGetAdvancedResultInfo"
}
]
},
"description": "結果陣列"
}
}
}
]
}
```
### Response36Afe1097B20_NewerModel
`#/components/schemas/Response36Afe1097B20_NewerModel`
```json
{
"type": "object",
"properties": {
"title": {
"type": [
"string",
"null"
],
"description": "商品標題"
},
"newer_model_asin": {
"type": [
"string",
"null"
],
"description": "較新產品型號的 ASIN"
}
}
}
```
### Response36Afe1097B20_RatingElement
`#/components/schemas/Response36Afe1097B20_RatingElement`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"position": {
"type": [
"string",
"null"
],
"description": "元素在 Google Shopping SERP 中的對齊方式
可能的值：
left、right"
},
"rating_type": {
"type": [
"string",
"null"
],
"description": "評分類型
此處可以找到下列元素：Max5、Percents、CustomMax"
},
"value": {
"type": [
"number",
"null"
],
"description": "評分的值"
},
"votes_count": {
"type": [
"integer",
"null"
],
"description": "回饋數量",
"format": "int64"
},
"rating_max": {
"type": [
"integer",
"null"
],
"description": "rating_type 的最大值"
}
}
}
```
### Response36Afe1097B20_RatingInfo
`#/components/schemas/Response36Afe1097B20_RatingInfo`
```json
{
"properties": {
"rating_type": {
"type": [
"string",
"null"
],
"description": "評分類型\n此處可以找到下列元素：Max5、Percents、CustomMax"
},
"value": {
"type": [
"number",
"null"
],
"description": "評分的值",
"format": "double"
},
"votes_count": {
"type": [
"integer",
"null"
],
"description": "回饋數量",
"format": "int64"
},
"rating_max": {
"type": [
"integer",
"null"
],
"description": "rating_type 的最大值"
}
}
}
```
### Response36Afe1097B20_UserProfileInfo
`#/components/schemas/Response36Afe1097B20_UserProfileInfo`
```json
{
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"avatar": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
],
"description": "相關 URL"
},
"reviews_count": {
"type": [
"integer",
"null"
],
"format": "int64"
},
"locations": {
"type": [
"string",
"null"
]
}
}
}
```
### Response36Afe1097B20_VideoElement
`#/components/schemas/Response36Afe1097B20_VideoElement`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "元素類型"
},
"source": {
"type": [
"string",
"null"
],
"description": "影片來源的 URL"
},
"preview": {
"type": [
"string",
"null"
],
"description": "影片預覽圖片的 URL"
},
"title": {
"type": [
"string",
"null"
],
"description": "指定連結元素的標題"
},
"timestamp": {
"type": [
"string",
"null"
],
"description": "結果發布的日期與時間
採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
範例：
2019-11-15 12:57:46 +00:00"
},
"url": {
"type": [
"string",
"null"
],
"description": "來源 URL"
}
}
}
```