> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # 关键词排名 > 此端点将提供目标产品在 Amazon 上获得排名的关键词列表。 ## OpenAPI ````yaml openapi/zh/dataforseo.json POST /dataforseo/dataforseo_labs/amazon/ranked_keywords/live openapi: 3.0.3 info: title: DataForSEO API version: 1.0.0 description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。 servers: - url: https://api.aisa.one/apis/v1 security: - BearerAuth: [] paths: /dataforseo/dataforseo_labs/amazon/ranked_keywords/live: post: summary: 关键词排名 description: >- 此端点将提供目标产品在 Amazon 上获得排名的关键词列表。返回的结果特定于 POST 请求中指定的 `asin`。有关 ASIN 的更多信息，请参阅[此帮助中心文章。](https://dataforseo.com/help-center/asin-in-amazon-api) operationId: post_dataforseo_dataforseo_labs_amazon_ranked_keywords_live requestBody: required: true content: application/json: schema: type: object properties: asin: type: string description: >- 产品 ID 必填字段 Amazon 上的唯一产品标识符（ASIN）；您可以通过单独请求 Amazon Products 端点获取 asin 参数 location_name: type: string description: >- 位置的完整名称。如果未指定 location_code，则为必填字段。可通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求，获取包含 location_name 的可用位置列表。注意：此端点目前仅支持美国、埃及、沙特阿拉伯和阿拉伯联合酋长国的位置。示例：United States location_code: type: integer description: >- 位置代码；如果未指定 location_name，则为必填字段；您可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发出请求，获取可用位置及其 location_code 的列表；注意：此端点目前仅支持美国、埃及、沙特阿拉伯和阿拉伯联合酋长国的位置；示例：2840 language_name: type: string description: >- 语言全名 必填字段 如果未指定 language_code，可以向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求，以获取可用语言及其 language_name 的列表 示例：English language_code: type: string description: >- 语言代码；如果未指定 language_name，则为必填字段；可通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发起请求，获取可用语言及其 language_code 列表；示例：en limit: type: integer description: 结果数组中的最大产品数量，可选字段，默认值：100；最大值：1000 ignore_synonyms: type: boolean description: 忽略高度相似的关键词，可选字段。如果设置为 true，则仅返回核心关键词，并排除所有高度相似的关键词；默认值：false filters: type: array items: type: string description: >- 结果过滤参数数组 可选字段 可以同时添加多个过滤器（最多 8 个过滤器）应在条件之间设置逻辑运算符 and、or 支持以下运算符：regex、not_regex、,、,、>、>=、=、,、in、not_in、like、not_like、match、not_match 可以将 % 运算符与 like 和 not_like 配合使用，以匹配由零个或多个字符组成的任意字符串 示例：["keyword_data.keyword_info.search_volume","in",[100,1000]]；有关过滤器的更多信息，请参阅 Dataforseo Labs – Filters 或此帮助中心指南 order_by: type: array items: type: string description: >- 结果排序规则，可选字段。你可以使用与 filters 数组中相同的值对结果进行排序。可用排序类型：asc – 结果将按升序排列；desc – 结果将按降序排列。应使用逗号设置排序参数。示例：["keyword_data.keyword_info.competition,desc"]。默认规则：["ranked_serp_element.serp_item.rank_group,asc"]。请注意，单个请求最多可以设置三个排序规则。应使用逗号分隔多个排序规则。示例：["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,desc"] offset: type: integer description: >- 返回关键词的结果数组中的偏移量，可选字段，默认值：0。如果指定值 10，结果数组中的前十个关键词将被省略，并提供后续关键词的数据 tag: type: string description: >- 用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data 对象中找到指定的 tag 值 required: - asin - location_name - location_code - language_name - language_code responses: '200': description: 成功响应 content: application/json: schema: type: object properties: version: type: string description: API 的当前版本 status_code: type: integer description: 通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况 status_message: type: string description: 常规信息消息；可在此处查看常规信息消息的完整列表 time: type: string description: 执行时间（秒） cost: type: number description: 任务总成本（美元） tasks_count: type: integer description: tasks 数组中的任务数量 tasks_error: type: integer description: 返回错误的 tasks 数组中的任务数量 tasks: type: array items: type: string description: 任务数组 tasks.id: type: string description: 任务标识符，系统中采用 UUID 格式的唯一任务标识符 tasks.status_code: type: integer description: DataForSEO 生成的任务状态码；范围为：10000-60000；完整响应代码列表可在此处查看 tasks.status_message: type: string description: 任务的信息性消息，你可以在此处查看通用信息性消息的完整列表 tasks.time: type: string description: 执行时间（秒） tasks.cost: type: number description: 任务成本（美元） tasks.result_count: type: integer description: 结果数组中的元素数量 tasks.path: type: array items: type: string description: URL 路径 tasks.data: type: object description: 包含您在 POST 请求中指定的相同参数 tasks.result: type: array items: type: string description: 结果数组 tasks.result.se_type: type: string description: 搜索引擎类型 tasks.result.asin: type: string description: POST 数组中的 ASIN tasks.result.location_code: type: integer description: POST 数组中的位置代码；如果没有数据，则值为 null tasks.result.language_code: type: string description: POST 数组中的语言代码；如果没有数据，则值为 null tasks.result.total_count: type: integer description: 数据库中与您的请求相关的结果总量 tasks.result.items_count: type: integer description: items 数组中返回的结果数量 tasks.result.items: type: array items: type: string description: 包含检测到的 Amazon 产品竞争对手及相关数据 tasks.result.items.se_type: type: string description: 搜索引擎类型 tasks.result.items.keyword_data: type: object description: 返回关键词的关键词数据 tasks.result.items.keyword_data.se_type: type: string description: 搜索引擎类型 tasks.result.items.keyword_data.keyword: type: string description: 返回的关键词 tasks.result.items.keyword_data.location_code: type: integer description: POST 数组中的位置代码 tasks.result.items.keyword_data.language_code: type: string description: POST 数组中的语言代码 tasks.result.items.keyword_data.keyword_info: type: object description: 返回关键词的关键词信息 tasks.result.items.keyword_data.keyword_info.se_type: type: string description: 搜索引擎类型 tasks.result.items.keyword_data.keyword_info.last_updated_time: type: string description: >- keyword 数据更新的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；示例：2019-11-15 12:57:46 +00:00 tasks.result.items.keyword_data.keyword_info.search_volume: type: integer description: 平均每月搜索量，表示返回的关键词在 Amazon 上的（近似）搜索次数 tasks.result.items.ranked_serp_element: type: object description: 包含为返回的关键词找到的产品 SERP 元素相关数据 tasks.result.items.ranked_serp_element.se_type: type: string description: 搜索引擎类型 tasks.result.items.ranked_serp_element.serp_item: type: object description: 包含 SERP 元素的数据，支持的 SERP 元素列表见下文 tasks.result.items.ranked_serp_element.serp_item.se_type: type: string description: 搜索引擎类型 tasks.result.items.ranked_serp_element.serp_item.type: type: string description: 元素类型 = ‘amazon_serp’ tasks.result.items.ranked_serp_element.serp_item.rank_group: type: integer description: 在 type 值相同的元素组内的位置；type 值不同的元素位置不会计入 rank_group。 tasks.result.items.ranked_serp_element.serp_item.rank_absolute: type: integer description: Amazon SERP 中的绝对排名，即在 SERP 所有元素中的绝对位置 tasks.result.items.ranked_serp_element.serp_item.position: type: string description: 元素在 Amazon SERP 中的对齐方式可取以下值：left、right tasks.result.items.ranked_serp_element.serp_item.xpath: type: string description: 元素的 XPath tasks.result.items.ranked_serp_element.serp_item.domain: type: string description: Amazon 域名 tasks.result.items.ranked_serp_element.serp_item.title: type: string description: 产品标题 tasks.result.items.ranked_serp_element.serp_item.url: type: string description: 产品页面的 URL tasks.result.items.ranked_serp_element.serp_item.description: type: string description: 产品描述 tasks.result.items.ranked_serp_element.serp_item.asin: type: string description: 产品的 ASIN；有关 ASIN 的更多信息，请参阅此帮助中心指南 tasks.result.items.ranked_serp_element.serp_item.image_url: type: string description: 结果中展示的产品图片 URL tasks.result.items.ranked_serp_element.serp_item.price_from: type: number description: 产品的常规价格，例如：49.98 tasks.result.items.ranked_serp_element.serp_item.price_to: type: number description: 产品价格范围的上限，示例：384.99 tasks.result.items.ranked_serp_element.serp_item.currency: type: string description: ISO 格式的货币，例如：USD tasks.result.items.ranked_serp_element.serp_item.special_offers: type: array items: type: string description: 特别优惠详情，包含优惠券和 Subscribe & Save 折扣等特别优惠信息 tasks.result.items.ranked_serp_element.serp_item.is_best_seller: type: boolean description: “Best Seller”标签；如果值为 true，则产品会被标记为“Best Seller” tasks.result.items.ranked_serp_element.serp_item.is_amazon_choice: type: boolean description: “Amazon’s choice”标签，如果值为 true，则产品会标有“Amazon’s choice”标签 tasks.result.items.ranked_serp_element.serp_item.rating: type: object description: 该条目的评分，即基于评论得出的热度评分，并显示在 SERP 中 tasks.result.items.ranked_serp_element.serp_item.rating.rating_type: type: string description: 评分类型；可使用以下值：Max5、Percents、CustomMax tasks.result.items.ranked_serp_element.serp_item.rating.value: type: integer description: 评级值 tasks.result.items.ranked_serp_element.serp_item.rating.votes_count: type: integer description: 反馈数量 tasks.result.items.ranked_serp_element.serp_item.rating.rating_max: type: integer description: rating_type 的最大值 tasks.result.items.ranked_serp_element.serp_item.delivery_info: type: object description: 配送信息，包括免费配送和快速配送的日期范围 tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_message: type: string description: 配送信息；卖家发布的配送信息所附消息 tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price: type: object description: 配送价格 根据你在 POST 请求中指定的位置计算的配送价格；如果提供免费配送，则值为 null tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.current: type: number description: 当前交割价格 tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.regular: type: number description: 常规未折扣配送价格 tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.max_value: type: number description: 未折现最高交割价格 tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.currency: type: string description: ISO 格式的货币代码 tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.is_price_range: type: boolean description: 指示配送价格是否为区间 tasks.result.items.ranked_serp_element.serp_item.delivery_info.delivery_price.displayed_price: type: string description: Amazon 商品信息中显示的价格行 tasks.result.items.ranked_serp_element.check_url: type: string description: Amazon 结果的直接 URL，您可以使用该 URL 确认我们提供的结果准确无误 tasks.result.items.ranked_serp_element.serp_item_types: type: array items: type: string description: >- Amazon 结果的直接 URL；包含返回的 SERP 中找到的所有搜索结果（项目）类型；可能的项目类型：amazon_serp、amazon_paid、editorial_recommendations、top_rated_from_our_brands、related_searches tasks.result.items.ranked_serp_element.se_results_count: type: integer description: Amazon SERP 中的结果总数 tasks.result.items.ranked_serp_element.last_updated_time: type: string description: >- SERP 数据最后更新的日期和时间，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；示例：2019-11-15 12:57:46 +00:00 tasks.result.items.ranked_serp_element.previous_updated_time: type: string description: >- SERP 数据最近一次更新的前一次更新时间，采用 ISO 8601 格式：“YYYY-MM-DDThh:mm:ss.sssssssZ” 示例：2020-09-12T00:07:43.0733218Z tasks.result.items.ranked_serp_element.previous_updated_time.se_type: type: string description: 搜索引擎类型 tasks.result.items.ranked_serp_element.previous_updated_time.type: type: string description: 元素类型 = ‘related_searches’ tasks.result.items.ranked_serp_element.previous_updated_time.rank_group: type: integer description: 在 type 值相同的元素组内的位置；type 值不同的元素位置不会计入 rank_group。 tasks.result.items.ranked_serp_element.previous_updated_time.rank_absolute: type: integer description: Amazon SERP 中的绝对排名，即在 SERP 所有元素中的绝对位置 tasks.result.items.ranked_serp_element.previous_updated_time.position: type: string description: 元素在 Amazon SERP 中的对齐方式可取以下值：left、right tasks.result.items.ranked_serp_element.previous_updated_time.xpath: type: string description: 元素的 XPath tasks.result.items.ranked_serp_element.previous_updated_time.domain: type: string description: Amazon 域名 tasks.result.items.ranked_serp_element.previous_updated_time.title: type: string description: 产品标题 tasks.result.items.ranked_serp_element.previous_updated_time.url: type: string description: 产品页面的 URL tasks.result.items.ranked_serp_element.previous_updated_time.description: type: string description: 产品描述 tasks.result.items.ranked_serp_element.previous_updated_time.asin: type: string description: 产品的 ASIN；有关 ASIN 的更多信息，请参阅此帮助中心指南 tasks.result.items.ranked_serp_element.previous_updated_time.image_url: type: string description: 结果中展示的产品图片 URL tasks.result.items.ranked_serp_element.previous_updated_time.price_from: type: number description: 产品的常规价格，例如：49.98 tasks.result.items.ranked_serp_element.previous_updated_time.price_to: type: number description: 产品价格范围的上限，示例：384.99 tasks.result.items.ranked_serp_element.previous_updated_time.currency: type: string description: ISO 格式的货币，例如：USD tasks.result.items.ranked_serp_element.previous_updated_time.special_offers: type: array items: type: string description: 特别优惠详情，包含优惠券和 Subscribe & Save 折扣等特别优惠信息 tasks.result.items.ranked_serp_element.previous_updated_time.is_best_seller: type: boolean description: “Best Seller”标签；如果值为 true，则产品会被标记为“Best Seller” tasks.result.items.ranked_serp_element.previous_updated_time.is_amazon_choice: type: boolean description: “Amazon’s choice”标签，如果值为 true，则产品会标有“Amazon’s choice”标签 tasks.result.items.ranked_serp_element.previous_updated_time.rating: type: object description: 该条目的评分，即基于评论得出的热度评分，并显示在 SERP 中 tasks.result.items.ranked_serp_element.previous_updated_time.rating.rating_type: type: string description: 评分类型；可使用以下值：Max5、Percents、CustomMax tasks.result.items.ranked_serp_element.previous_updated_time.rating.value: type: integer description: 评级值 tasks.result.items.ranked_serp_element.previous_updated_time.rating.votes_count: type: integer description: 反馈数量 tasks.result.items.ranked_serp_element.previous_updated_time.rating.rating_max: type: integer description: rating_type 的最大值 tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info: type: object description: 配送信息，包括免费配送和快速配送的日期范围 tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_message: type: string description: 配送信息；卖家发布的配送信息所附消息 tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price: type: object description: 配送价格 根据你在 POST 请求中指定的位置计算的配送价格；如果提供免费配送，则值为 null tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.current: type: number description: 当前交割价格 tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.regular: type: number description: 常规未折扣配送价格 tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.max_value: type: number description: 未折现最高交割价格 tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.currency: type: string description: ISO 格式的货币代码 tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.is_price_range: type: boolean description: 指示配送价格是否为区间 tasks.result.items.ranked_serp_element.previous_updated_time.delivery_info.delivery_price.displayed_price: type: string description: Amazon 商品信息中显示的价格行 tasks.result.items.ranked_serp_element.previous_updated_time.items: type: array items: type: string description: 包含 tasks.result.items.ranked_serp_element.previous_updated_time.items.type: type: string description: 元素类型 = ‘related_searches_element’ tasks.result.items.ranked_serp_element.previous_updated_time.items.title: type: string description: 产品标题 tasks.result.items.ranked_serp_element.previous_updated_time.items.url: type: string description: 产品页面的 URL tasks.result.items.ranked_serp_element.previous_updated_time.items.image_alt: type: string description: 结果中展示的产品图片的 alt 标签 tasks.result.items.ranked_serp_element.previous_updated_time.items.image_url: type: string description: 结果中展示的产品图片 URL '400': description: 错误请求 '401': description: 未授权 '429': description: 超出速率限制 '500': description: 内部服务器错误 components: securitySchemes: BearerAuth: type: http scheme: bearer ````