# 按 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"
}
}
}
```