For the complete documentation index, see llms.txt. This page is also available as Markdown.

产品

使用网页爬虫API 轻松提取 Amazon 产品数据。借助自定义参数和示例,获取标题、价格、评论和详情。

amazon_product 数据源旨在检索 Amazon 商品页面。

请求示例

在下面的示例中,我们发起请求以检索 ASIN 的商品页面 B08Y72CH1Famazon.nl 市场。若提供的 ASIN 是父 ASIN,我们会请求 Amazon 返回自动选择的变体商品页面。API 将返回解析后的结果。

curl 'https://realtime.oxylabs.io/v1/queries' \\
--user 'USERNAME:PASSWORD' \\
-H 'Content-Type: application/json' \\
-d '{
        "source": "amazon_product",
        "domain": "nl",
        "query": "B08Y72CH1F",
        "parse": true,
        "context": [
            {
                "key": "autoselect_variant",
                "value": true
            }
        ]
    }'
import requests
from pprint import pprint


# 结构化载荷。
payload = {
    'source': 'amazon_product',
    'domain': 'nl',
    'query': 'B08Y72CH1F',
    'parse': True,
    'context': [
        {'key': 'autoselect_variant', 'value': True}
    ],
}


# 获取响应。
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

我们在示例中使用同步 Realtime 集成方法。如果您想使用 Proxy Endpoint 或异步 Push-Pull 集成,请参阅 集成方法 部分。

请求参数值

通用

用于抓取 Amazon 商品页面的基本设置和自定义选项。

参数
描述
默认值

source

设置抓取器。

amazon_product

查询

10 位 ASIN 代码。

-

render

设置为时启用 JavaScript 渲染 html. 更多信息.

-

解析

设置为以下值时返回解析后的数据: true。查看输出 数据字典.

false

callback_url

回调端点的 URL。 更多信息.

-

user_agent_type

设备类型和浏览器。完整列表可在 此处.

desktop

- 必填参数

本地化

将结果适配到特定地理位置、域名和语言。

参数
描述
默认值

geo_location

配送至 位置。请参阅我们关于使用此参数的指南 此处.

-

domain

Amazon 的域名本地化。可用域名完整列表可在 此处.

com

locale

Accept-Language header 值,用于设置 Amazon 页面的界面语言。 更多信息.

-

其他

针对特殊需求的其他高级设置和控件。

参数
描述
默认值

context: autoselect_variant

要获取准确的定价/buybox 数据,请将此参数设置为 true (这表示要在商品 URL 末尾追加 th=1&psc=1 URL 参数)。要准确呈现父 ASIN 的商品页面,请省略此参数,或将其设置为 false.

false

context: 货币

设置货币。查看可用值 此处.

取决于市场。查看默认值 此处.

代码示例

结构化数据

网页爬虫API 能够提取包含 Amazon 商品结果的 HTML 或 JSON 对象,并为结果页的各个元素提供结构化数据。

amazon_product 结构化输出

输出数据字典

可使用右侧导航或向下滚动页面查看详情。

在以下部分中,当某个结果类型有多个项目可用时,已将解析后的 JSON 代码片段缩短。

HTML 示例

JSON 结构

下表列出了我们解析的每个 Amazon 商品页面元素的详细清单,包括其描述、数据类型,以及该元素在页面布局中是否始终存在,或是否取决于您选择抓取的商品而可选。该表还包含一些元数据。

描述
类型
布局

url

Amazon 商品的 URL。

字符串

page

当前页码。

整数

page_type

标识 Amazon 页面类型。

字符串

asin

Amazon 标准识别号。

字符串

asin_in_url

从 URL 中提取 Amazon 标准识别号。

字符串

title

产品标题。

字符串

manufacturer

商品制造商名称。

字符串

product_name

商品名称。

字符串

description

商品描述,解析自“Product description”部分。

字符串

bullet_points

解析自“About this product”部分的要点列表。

字符串

可选

类别

包含 Amazon 商品类别更多详细信息的列表。

数组

可选

variation

包含 Amazon 商品变体更多详细信息的列表。

数组

可选

rating

产品评分。

整数

price

产品价格。

浮点数

price_upper

价格上限。

浮点数

可选

price_sns

标识商品是否属于“Subscribe & Save”计划。

浮点数

price_initial

商品的原始未折扣价格。

浮点数

price_shipping

运费。

浮点数

可选

price_buybox

buybox 中显示的商品价格。

浮点数

deal_type

标识促销优惠的类别。

字符串

可选

coupon

表示可用的数字优惠。

字符串

可选

is_prime_eligible

表示该产品是否符合 Amazon Prime 资格。

布尔值

is_addon_item

表示商品是否仅在订单达到最低金额门槛时才可购买。

布尔值

可选

货币

价格所使用的货币。

字符串

discount_end

表示 Amazon 商品促销折扣的有效截止日期。

字符串

可选

stock

表示商品库存水平。

字符串

reviews_count

商品的评论数量。

整数

reviews

包含评论及其各自详细信息的列表。

数组

answered_questions_count

关于 Amazon 商品已获回答的客户问题总数。

整数

可选

pricing_count

商品的定价数量。

整数

可选

pricing_url

用于获取 Amazon 商品报价列表的 URL。

字符串

可选

pricing_str

Amazon 商品定价详情的字符串表示。此属性包括当前价格、任何折扣、促销和特别优惠的信息。

字符串

可选

featured_merchant

关于 Amazon 商品所突出显示的主要卖家或供应商的详细信息列表。

对象

可选

sales_rank

关于 Amazon 商品根据销售表现在其所属类别中的排名位置的信息列表。

数组

可选

sns_discounts

表示“Subscribe & Save”计划中的任何可用折扣。

数组

developer_info

与 Amazon 商品的开发者或制造商相关的信息。

对象

可选

images

指向商品图片的 URL 列表。

数组

product_overview

商品关键属性及其描述的列表,提供有关商品特征的基本信息。

数组

可选

store_url

卖家店铺网页的 URL。

字符串

可选

has_videos

表示商品是否有视频。

布尔值

delivery

配送选项信息列表。

对象

可选

品牌

商品的品牌。

字符串

可选

item_form

指定商品的物理形态或类型,说明其包装或交付使用的方式。

字符串

可选

sales_volume

特定时间范围内售出的单位数量。

字符串

可选

other_sellers

列出该商品的其他卖家详情,包括卖家数量、其中的起始价格以及基本配送信息。

字符串

可选

rating_stars_distribution

商品评分详情列表。

数组

可选

buybox

商品定价详情列表。

数组

可选

lightning_deal

表示商品是否有有限时促销优惠。

对象

可选

product_details

商品详细信息列表。

对象

可选

product_dimensions

商品尺寸。

字符串

可选

max_quantity

客户单笔订单允许购买的 Amazon 商品最大数量。

整数

可选

warranty_and_support

商品保修信息列表。

对象

可选

discount.percentage

应用于 Amazon 商品原价的折扣百分比。

整数

可选

amazon_choice

表示商品是否带有 Amazon's Choice 徽章。

布尔值

可选

coupon_discount_percentage

表示优惠券可享受的折扣百分比。

整数

可选

parent_asin

商品所属 Amazon 商品系列的主要标识符。

字符串

可选

创建时间

抓取任务创建时的时间戳。

时间戳

更新时间

抓取任务完成时的时间戳。

时间戳

任务ID

与该抓取任务关联的任务 ID。

字符串

状态码

抓取任务的状态码。你可以查看所描述的抓取器状态码 此处.

整数

parse_status_code

解析任务的状态码。你可以查看所描述的解析器状态码 此处.

整数

类别

此字段显示 Amazon 商品类别的层级结构。层级中的每个类别都是一个包含名称和 URL 的对象,表示从最宽泛类别到最具体子类别的路径。

键(类别)
描述
类型

层级

包含 Amazon 商品面包屑导航的列表。

数组

ladder.name

Amazon 商品面包屑/类别的名称。

字符串

ladder.url

面包屑/类别的 URL。

字符串

广告

此字段包含 Amazon 商品页面上显示的广告信息。每个广告都以一个对象表示,包含类型、位置、标题、ASIN、图片、位置、评分、评论数、Prime 资格和价格等详情。

键(ads)
描述
类型

type

Amazon 广告类型。

字符串

location

Amazon 广告位名称。

字符串

title

产品标题。

字符串

asin

Amazon 标准识别号。

字符串

images

商品图片的 URL。

字符串

pos

用于表示广告在所有可用广告结果中的位置的唯一标识符。

整数

rating

产品评分。

整数

reviews_count

商品的评论数量。

整数

is_prime_eligible

表示该产品是否符合 Amazon Prime 资格。

布尔值

price

产品价格。

浮点数

price_upper

适用时的价格上限。

浮点数

评分星级分布

此字段包含商品星级评分的分布情况。每个对象代表一个星级以及给出该评分的评论占总评论的百分比。

键(rating_stars_distribution)
描述
类型

rating

表示评分数值(从 5 到 1)。

整数

百分比

表示该评分对应的百分比。

字符串

评论

包含该商品的客户评论,每条评论都以包含相关详情的对象表示。

键(reviews)
描述
类型

id

Amazon 评论的字母数字标识。

字符串

title

评论的评分和标题。

字符串

author

提交该评论的用户。

字符串

rating

提交评论时给出的星级评分,通常为 1 到 5。

整数

content

评论内容的完整文本。

字符串

时间戳

按 Amazon 提供的格式显示的评论日期和地点。

字符串

profile_id

评论作者资料的唯一标识符,用于链接到其 Amazon 个人资料。

字符串

is_verified

表示评论是否来自已验证购买。

布尔值

review_from

提供有关评论来源的额外上下文(例如特定地区评论或热门评论)。

字符串

helpful_count (可选)

该评论获得的有用投票数。

整数

product_attributes (可选)

标识商品特征。

字符串

image (可选)

作者附加到评论中的图片 URL 列表。

数组

变体

此字段包含商品不同变体的信息,例如颜色、尺寸、款式等。每个变体都以一个对象表示,包含 ASIN、选择状态、规格(如颜色、尺寸、款式等属性)以及提示图片 URL 等详情。

键(变体)
描述
类型
布局

asin

商品变体的 Amazon 标准识别号。

数组

selected

标识已选中的商品变体。

布尔值

dimensions

变体商品的规格。

对象

可选

dimensions.size

变体商品的尺寸。

字符串

可选

dimensions.color

变体商品的颜色。

字符串

可选

dimensions.style

变体商品的款式。

字符串

可选

dimensions.unit count

变体商品的标准单位数。

字符串

可选

tooltip_image

变体图片的 URL。

字符串

可选

保修与支持

此字段包含商品的保修和支持选项信息。它包括商品保修说明以及获取保修信息的链接。

键 (warranty_and_support)
描述
类型

description

产品可享保修的说明。

字符串

links

包含更多产品保修信息的列表。

数组

links.title

保修标题。

字符串

links.url

包含更多产品保修信息的 URL。

字符串

精选卖家

此字段提供有关销售该产品的精选卖家信息。它包括卖家名称、卖家 ID、卖家页面链接、产品是否由 Amazon 配送以及发货地等详细信息。

键 (featured_merchant)
描述
类型

姓名

主卖家的名称。

字符串

seller_id

卖家 ID。

字符串

link

Amazon 卖家页面的 URL。

字符串

is_amazon_fulfilled

表示产品是否由 Amazon 自有物流网络履约

布尔值

shipped_from (可选)

表示发货地点。

字符串

销售排名

此字段提供产品在 Amazon 特定类别中的销售排名信息。每个对象表示一条销售排名记录,包括排名本身和类别层级,显示通向该排名类别的分类层次结构。

键 (sales_rank)
描述
类型

rank

表示排名位置。

整数

层级

包含产品所排名类别的更详细信息列表。

数组

ladder.url

相关畅销品类页面的 URL。

字符串

ladder.name

表示产品所排名的类别。

字符串

配送

此字段提供产品配送选项的信息,例如最快配送方式和预计送达日期。

键 (delivery)
描述
类型

type

表示配送类型。

字符串

date

配送日期信息列表。

对象

date.from

发货地点。

字符串

date.by

预计送达日期。

字符串

购买框

Amazon 商品页上的“buy box”部分,顾客可直接购买商品。此字段提供买家所需的关键信息,包括产品价格、库存可用性、配送选项和预计送达日期。

键 (buybox)
描述
类型
布局

姓名

定价选项的名称。

字符串

可选

stock

产品库存水平。

字符串

可选

delivery_type

表示配送类型。

字符串

可选

delivery_details

产品配送详情列表。

数组

可选

date

配送日期详情列表。

对象

可选

delivery_details.by

预计送达日期。

字符串

可选

delivery_details.from

商品的发货地点。

字符串

可选

delivery_details.type

配送类型

字符串

可选

condition

商品的成色。

字符串

可选

price

产品价格。

浮点数

闪电优惠

此字段提供有关 Amazon 闪电优惠的详细信息,提供限时折扣价。闪电优惠是限时促销,针对特定产品提供大幅折扣,仅在数量有限的情况下持续数小时。顾客必须迅速行动,因为优惠会在分配时间结束或库存用尽后失效。详情包括已领取百分比、折扣价和优惠剩余时间。

键 (lightning_deal)
描述
类型

已领取百分比

相较默认价格的折扣金额。

字符串

price_text

折扣后的产品价格。

字符串

expires

表示闪电优惠的结束时间。

字符串

产品概览

此部分提供与产品相关的各项关键属性的结构化摘要。

键 (product_overview)
描述
类型

product_overview

产品关键属性及其说明列表。

数组

title

产品属性标题。

字符串

description

产品属性的详细说明。

字符串

最后更新于

这有帮助吗?