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

搜索

使用网页爬虫API 抓取 Amazon 搜索结果。借助 JS 渲染、地理定位和示例,获取产品标题、价格、评分等信息。

amazon_search 数据源旨在检索 Amazon 搜索结果页面。要查看包含检索数据的响应示例,请下载 示例输出 HTML 格式的文件,或查看结构化数据输出 这里.

查看输出 数据字典 适用于每个 Amazon Search 功能,提供简要说明、截图、解析后的 JSON 代码片段,以及定义每个解析字段的表格。可使用右侧导航或向下滚动页面查看详细信息。

请求示例

在下面的代码示例中,我们发送请求以从 amazon.com检索结果,其中包括 2 搜索结果页面,从第 #2 页开始,搜索词为 nirvana tshirt。此外,搜索将限制为分类 ID: 16391693031 并且价格以 USD 货币显示。

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "amazon_search",
        "domain": "com",
        "query": "nirvana tshirt",
        "start_page": 2,
        "pages": 2,
        "parse": true,
        "context": [
                {"key": "category_id", "value": "16391693031"},
                {"key": "currency", "value": "USD"},
                {"key": "refinements", "value": ["p_123:256097"]},
                {"key": "sort_by", "value": "featured"}
        ]
    }'
import requests
from pprint import pprint


# 构造载荷。
payload = {
    'source': 'amazon_search',
    'domain': 'com',
    'query': 'nirvana tshirt',
    'start_page': 2,
    'pages': 2,
    'parse': True,
    'context': [
        {'key': 'category_id', 'value': 16391693031},
        {'key': 'currency', 'value': 'USD'},
        {"key": "refinements", "value": ["p_123:256097"]},
        {"key": "sort_by", "value": "featured"}
    ],
}


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

# 将美化后的响应打印到标准输出。
pprint(response.json())

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

请求参数值

通用

用于抓取 Amazon 搜索结果的基本设置和自定义选项。

参数
说明
默认值

source

设置爬虫。

amazon_search

query

要搜索的关键词或短语。

-

render

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

-

parse

返回解析后的数据,当设置为 true。查看输出 数据字典.

false

callback_url

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

-

user_agent_type

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

desktop

context: currency

设置货币。可用值请查看 这里.

-

- 必需参数

本地化

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

参数
说明
默认值

geo_location

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

-

domain

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

com

locale

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

-

分页

用于管理搜索结果分页和检索的控制项。

参数
说明
默认值

start_page

起始页码。

1

pages

要抓取的页数。

1

排序和筛选

用于控制搜索结果页面的排序和筛选。

参数
说明
默认值

context: sort_by

根据 Amazon 中可用值之一设置搜索结果页的排序类型: "most_recent", "price_low_to_high", "price_high_to_low", "featured", "average_review", "bestsellers".

-

context: refinements

一个 列表 Amazon 搜索细化参数,用于对搜索结果应用特定筛选。这些参数对应 Amazon 的动态筛选选项(例如品牌、价格范围、功能),并遵循 Amazon 的内部参数格式,例如 p_123:256097p_n_feature_twenty-eight_browse-bin:98209020031.

由于筛选选项因类目而异,并由 Amazon 动态生成,推荐的工作流程是:

  1. 首先,使用 parse: true 来发现可用的筛选项

  2. 从解析后的响应中提取所需的筛选参数

  3. 在后续请求中通过 refinements 该字段应用特定筛选

-

context: min_price / max_price

按价格区间筛选结果。两个值均以分为单位,而不是主货币单位: min_price: 5000max_price: 10000 可返回 $50.00 到 $100.00 之间的商品。必须为正整数。任一参数都可单独使用。

context: category_id

搜索特定 Amazon 节点(产品类目)中的商品。

-

context: merchant_id

搜索由特定卖家销售的商品。

-

结构化数据

amazon_search 结构化输出

输出示例已缩短。

输出数据字典

API 返回一个 HTML 或 JSON 对象,其中包含从 Amazon 获取的搜索结果。

HTML 示例

JSON 结构

所有搜索结果都包含在 results JSON 数组中。每个搜索结果包含以下内容的组合: paid, organic, suggested, amazons_choices,instant_recommendations 列表。此外,可能还会存在变体,这些变体会被捕获在 variations 键中,提供不同类型或类别商品的详细信息,例如各种型号、版本或款式。

说明
类型

url

Amazon 搜索页面的 URL。

字符串

page

当前页码。

整数

pages

总页数。

整数

query

所使用的搜索查询。

字符串

results

包含搜索结果的字典。

对象

results.paid

包含各自详情的赞助商品列表。

数组

results.organic

包含各自详情的自然商品列表。

数组

results.suggested

包含各自详情的推荐商品列表。

数组

results.amazons_choices

包含各自详情的 Amazon 精选商品列表。

数组

refinements

此搜索页面可用的筛选项列表。

数组

parse_status_code

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

整数

total_results_count

该搜索查询找到的结果总数。

整数

created_at

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

字符串

updated_at

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

字符串

job_id

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

字符串

status_code

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

整数

parser_type

用于解析数据的解析器类型。

字符串

在以下章节中,当某种结果类型有多个项目可用时,解析后的 JSON 代码片段会被缩短。

付费

paid 搜索结果中的“付费”部分指在 Amazon 搜索结果中显示的内嵌广告内容。

说明
类型

url

商品的 URL。

字符串

asin

Amazon 标准识别号。

字符串

price

商品价格。

浮点数

title

商品标题。

字符串

rating

商品评分。

浮点数

rel_pos

商品在搜索结果中的相对位置。

(以下二者之一 posrel_pos 存在)

整数

pos

表示列表中位置的唯一标识。(以下二者之一 posrel_pos 存在)

整数

currency

价格所使用的货币。

字符串

url_image

商品图片的 URL。

字符串

best_seller

表示该商品是否为畅销商品。

布尔值

price_upper

如果适用,则为价格上限。

浮点数

is_sponsored

表示该商品是否为赞助内容。

布尔值

manufacturer

商品制造商名称。

字符串

pricing_count

商品定价项数量。

整数

reviews_count

商品评论数量。

整数

coupon_discount

折扣金额。

整数(可选)

coupon_discount_type

折扣类型: 固定金额百分比.

字符串(可选)

is_amazons_choice

表示该商品是否标记为“Amazon 精选”。

布尔值

no_price_reason

如果价格为 0.0,则说明未显示价格的原因

字符串(可选)

sales_volume

某个商品的销量或售出数量。

字符串(可选)

is_prime

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

布尔值

shipping_information

关于商品配送详情的信息

字符串

自然

organic 搜索结果中的“自然”部分指根据 Amazon 搜索算法自然出现的非赞助内容。

名称
说明
类型

pos

表示列表中位置的唯一标识。

整数

url

商品的 URL。

字符串

asin

Amazon 标准识别号。

字符串

price

商品价格。

浮点数

title

商品标题。

字符串

rating

商品评分。

浮点数

currency

价格所使用的货币。

字符串

is_prime

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

布尔值

url_image

商品图片的 URL。

字符串

best_seller

表示该商品是否为畅销商品。

布尔值

price_upper

如果适用,则为价格上限。

浮点数

is_sponsored

表示该商品是否为赞助内容。

布尔值

manufacturer

商品制造商名称。

字符串

sales_volume

某个商品的销量或售出数量。

字符串(可选)

pricing_count

商品定价项数量。

整数

reviews_count

商品评论数量。

整数

coupon_discount

折扣金额。

整数(可选)

coupon_discount_type

折扣类型: 固定金额百分比.

字符串(可选)

is_amazons_choice

表示该商品是否为 Amazon 精选。

布尔值

price_strikethrough

任何折扣前的原价。

浮点数

shipping_information

送达日期和运费详情。

字符串

no_price_reason

如果价格为 0.0,则说明未显示价格的原因

字符串(可选)

variations

产品不同版本或型号的列表

数组

推荐

suggested 搜索结果中的“推荐”部分通常包含平台根据用户搜索查询、浏览历史或购买行为推荐的商品列表。

说明
类型

url

商品的 URL。

字符串

asin

Amazon 标准识别号。

字符串

price

商品价格。

浮点数

title

商品标题。

字符串

rating

商品评分。

浮点数

currency

价格所使用的货币。

字符串

url_image

商品图片的 URL。

字符串

best_seller

表示该商品是否为畅销商品。

布尔值

price_upper

如果适用,则为价格上限。

浮点数

is_sponsored

表示该商品是否为赞助内容。

布尔值

manufacturer

商品制造商名称。

字符串

pricing_count

商品定价项数量。

整数

reviews_count

商品评论数量。

整数

coupon_discount

折扣金额。

整数(可选)

coupon_discount_type

折扣类型: 固定金额百分比.

字符串(可选)

is_amazons_choice

表示该商品是否为 Amazon 精选。

布尔值

pos

表示列表中位置的唯一标识。

整数

is_prime

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

布尔值

shipping_information

关于商品配送详情的信息

字符串

sales_volume

某个商品的销量或售出数量。

字符串(可选)

no_price_reason

如果价格为 0.0,则说明未显示价格的原因

字符串(可选)

suggested_query

Amazon 在搜索结果中提供的建议查询。

字符串

亚马逊精选

amazons_choices 该版块展示带有“Amazon's Choice”徽章的产品,并因其被认为具有较高的质量和价值而获得平台推荐。

说明
类型

url

商品的 URL。

字符串

asin

Amazon 标准识别号。

字符串

price

商品价格。

浮点数

title

商品标题。

字符串

rating

商品评分。

浮点数

currency

价格所使用的货币。

字符串

url_image

商品图片的 URL。

字符串

best_seller

表示该商品是否为畅销商品。

布尔值

price_upper

如果适用,则为价格上限。

浮点数

is_sponsored

表示该商品是否为赞助内容。

布尔值

manufacturer

商品制造商名称。

字符串

pricing_count

商品定价项数量。

整数

reviews_count

商品评论数量。

整数

coupon_discount

折扣金额。

整数(可选)

coupon_discount_type

折扣类型: 固定金额百分比.

字符串(可选)

is_amazons_choice

表示该商品是否为 Amazon 精选。

布尔值

pos

表示列表中位置的唯一标识。

整数

is_prime

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

布尔值

shipping_information

关于商品配送详情的信息

字符串

sales_volume

某个商品的销量或售出数量。

字符串(可选)

no_price_reason

如果价格为 0.0,则说明未显示价格的原因

字符串(可选)

variations

产品不同版本或型号的列表

数组

变体

variations 该版块列出产品的不同版本或型号,提供指定类别中可用选项的详细概览。

说明
类型

asin

亚马逊标准识别编号

字符串

title

变体标题

字符串

price

变体价格

浮点数

price_strikethrough

任何折扣或促销前的原价

浮点数

not_available

指示该变体当前是否不可用

布尔值

最后更新于

这有帮助吗?