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

购物商品

使用网页爬虫API 检索详细的 Google Shopping 产品数据,包括价格、评论、规格和变体。

google_shopping_product source 从 Google Shopping 检索详细商品信息(标题、描述、定价、卖家、相关商品、评论等),使用一个 产品令牌 获取自 google_shopping_search (此处)或 google_search.

请求示例

在下面的代码示例中,我们使用一个有效令牌发起请求,以检索 Google Shopping 商品的商品页。

curl 'https://realtime.oxylabs.io/v1/queries' \\
--user 'USERNAME:PASSWORD' \\
-H 'Content-Type: application/json' \\
-d '{
       "source": "google_shopping_product",
       "query": "<PRODUCT_TOKEN>",
       "render": "html",
       "parse": true
    }'
import requests
from pprint import pprint


# 结构化载荷。
payload = {
    "source": "google_shopping_product",
    "query": "[product_token_string]",
    "render": "html",
    "parse": 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 集成,请参阅 集成方法 部分。

请求参数值

通用

用于抓取 Google Shopping 商品页的基础设置和自定义选项。

参数
描述
默认值

source

设置抓取器。

google_shopping_product

查询

产品令牌来源于 google_shopping_searchgoogle_search

-

render

设置为时启用 JavaScript 渲染 html. 必需 以从“更多商店”部分获取额外价格结果。 更多信息.

-

解析

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

false

callback_url

回调端点的 URL。 更多信息

-

user_agent_type

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

desktop

- 必填参数

本地化

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

参数
描述
默认值

geo_location

结果应适配的地理位置。正确使用此参数对于获取正确数据极其重要。有关更多信息,请阅读我们建议的 geo_location 参数结构 此处.

-

locale

Accept-Language 用于界面语言切换的 header 值。 更多信息.

-

结构化数据

下面可以找到一个 结构化输出示例google_shopping_product.

输出数据字典

HTML 示例

JSON 结构

下表详细列出了我们解析的每个商品页面元素,以及对应的描述和数据类型。表中还包含一些元数据。

描述
类型

url

Google Shopping 商品页面的 URL。

字符串

title (可选)

商品列表的标题。

字符串

description

商品的详细描述。

字符串

images

包含商品图片的对象。

对象

images.full_size

包含商品大图 URL 的数组。

数组

images.thumbnails

包含商品缩略图 URL 的数组。

数组

pricing

包含所有在线价格信息的数组。

数组

reviews

包含评论信息的对象。(仅限美国)

对象

variants

包含商品变体(颜色、尺寸等)的对象数组。

数组

related_items

包含相关项目的对象数组。

数组

规格

包含商品规格信息的对象数组。

数组

parse_status_code

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

整数

创建时间

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

时间戳

更新时间

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

时间戳

状态码

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

整数

任务ID

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

字符串

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

Pricing

包含商品价格信息的对象。

键(pricing[])
描述
类型

online

包含商品价格详情的对象数组。

数组

online.price

指定货币下的商品价格。

浮点数

online.seller

提供该商品的卖家或商家名称。

字符串

online.details

有关商品购买的其他详情,如配送和退货政策。

字符串

online.currency

商品价格的货币代码。

字符串

online.condition

商品的成色。

字符串

online.seller_link

卖家商品页面的 URL。

字符串

online.price_shipping

商品运费。

浮点数

评论

包含商品评论和评分信息的对象。

目前,评论仅在美国地区可用。

键(reviews[])
描述
类型

rating

商品的平均评分,通常满分为 5。

浮点数

top_review (可选)

包含商品最佳评论详情的对象。

对象

top_review.text (可选)

最佳评论的文本内容

字符串

top_review.title (可选)

最佳评论的标题。

字符串

top_review.author (可选)

最佳评论的作者。

字符串

top_review.rating (可选)

最佳评论作者给出的评分,通常满分为 5。

浮点数

top_review.source (可选)

发布最佳评论的网站或来源。

字符串

rating_stars

商品的平均评分,通常满分为 5 星。

浮点数

reviews_count (可选)

商品评论总数。

整数

review_count_by_stars

包含各星级评论数量的对象。

对象

review_count_by_stars.url (可选)

包含 X 星级评论详情的对象。

字符串

review_count_by_stars.reviews_count

X 星级评论数量。

整数

相关商品(更多选项)

包含目标商品相关项目的对象数组。

键(related_items[])
描述
类型

items

包含每个相关项目详情的对象数组。

数组

items.url

相关商品页面的 URL。

字符串

items.image

相关商品图片的 URL。

字符串

items.price

指定货币下的相关商品价格。

浮点数

items.title (可选)

相关商品列表的标题。

字符串

items.rating (可选)

相关商品的用户平均评分,通常满分为 5。

整数

items.store (可选)

提供该相关商品的商店或商家的名称。

字符串

items.currency

商品价格的货币代码。

字符串

items.reviews_count

相关商品的评论总数。

整数

title

相关商品部分的标题或标题文本

字符串

规格

包含商品规格详情的对象数组。

键 (specifications[])
描述
类型

items.title

规格的标题。

字符串

items.value

规格的值。

字符串

最后更新于

这有帮助吗?