Amazon 搜索,一目了然
来源 + 操作
GET /v1/amazon/search查询wireless earbuds
响应字段organic_results · 标题、价格、ASIN
示例数据
查找需要的数据来源
每个来源都有各自的端点、必填输入和响应结构。在构建集成之前,请打开其参考文档确认覆盖范围。
Google57
YouTube38
TikTok22
Reddit21
Amazon14
Bing11
eBay11
Naver11
Leboncoin10
LinkedIn10
Walmart10
Hacker News9
所有来源 (83)
Instagram9
DuckDuckGo8
US Economy8
Gab8
GitHub8
Goodreads8
Twitter (X)8
Vinted8
Bluesky7
Finance7
Immobiliare7
LoopNet7
Spotify7
Apple Music6
Gumtree6
Sephora6
Shopee6
Truth Social6
Weibo6
Yahoo6
AliExpress5
AutoScout245
Depop5
Facebook5
Hilton5
Klarna5
Kohl's5
Quora5
Realtor5
Rumble5
Target5
Threads5
Zillow5
Airbnb4
Apple4
Baidu4
ChatGPT4
Etsy4
H&M4
Pinterest4
Snapchat4
TikTok Shop4
Twitch4
Apartments.com3
Booking.com3
The Home Depot3
Kick3
Kwai3
Telegram3
Tripadvisor3
Trustpilot3
Wayfair3
Xiaohongshu (RED)3
Yandex3
Yelp3
AutoTrader2
Brave2
Douyin2
OpenTable2
Polymarket2
Dailymotion1
DEV Community1
GDELT1
Lemmy1
LinkMe1
Linktree1
lnk.bio1
Mastodon1
Product Hunt1
Stack Exchange1
Wikipedia1
发送第一次 Data API 请求
此 Amazon 示例使用来源专属的 GET 端点。HTTP 200 返回来源数据;HTTP 202 返回待处理状态和 jobId。在发送下一个请求之前,请在 Data API 控制台的“运行记录”页面查看待处理的任务。
# Install: pip install requests
import os
import requests
response = requests.get(
"https://api.capzy.ai/v1/amazon/search",
headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
params={"query": "wireless earbuds", "domain": "com"},
timeout=120,
)
response.raise_for_status()
data = response.json()
if response.status_code == 202:
print("Pending:", data.get("status"), "Job:", data.get("jobId"))
print("Inspect this job in https://capzy.ai/dashboard/data-api/runs")
else:
for item in data.get("organic_results", []):
print(item["title"], item.get("price"))
print("Credits used:", response.headers.get("X-Credits-Used"))调用前先了解接口约定
所有 Data API 来源共用同一套身份验证。请求方法、参数和返回字段则因端点而异。
X-API-Key必填 · 请求头- 在此请求头中发送你专属的 Data API 密钥。请将其保存在服务器端,并在这些示例中从 CAPZY_DATA_API_KEY 读取。
/v1/{source}/{path}因端点而异 · 路径- 遵循来源参考文档中的请求方法和路径。例如,GET /v1/amazon/search 将 query 和 domain 作为查询参数。
X-Credits-Used响应头- 查看该请求扣除的额度。端点价格和套餐折扣显示在控制台和来源参考文档中。
X-Next-Cursor响应头 · 存在时- 部分端点会返回指向下一页的游标。请使用各端点的分页参数;并非所有来源都使用相同的分页模型。
使用来源的实际响应字段
HTTP 200 的 Amazon 搜索响应在顶层提供 organic_results。HTTP 202 则返回带有 jobId 的状态封装;请在控制台的“运行记录”页面查看。这个简化的成功响应使用的是示意性商品数据。
价格
Data API 套餐包含每月额度。额外用量从你共享的 Capzy 账户余额中扣费。当前端点的额度价格请查看来源参考文档。
正在加载最新价格…
常见问题
演练场在哪里打开?
在“控制台 → Data API → 抓取器”中。来源链接会打开该来源的构建器。端点链接会预先选中对应的操作,让你在运行前查看必填输入。
我可以使用求解器 API 密钥吗?
请使用 Data API 控制台中显示的专属 Data API 密钥。Data API 有自己的套餐控制和内含额度,额外用量则由你共享的 Capzy 账户余额支付。
每个来源都返回相同的 JSON 吗?
不是。每个端点都有来源专属的响应结构。请查看其文档中的响应,并在你的应用中处理缺失或可选字段。
如果某个端点即将推出怎么办?
控制台会标记尚未验证或暂不可运行的端点。请使用那里显示的受支持操作;仅有参考文档条目并不代表端点已经就绪。
找到来源,试一次真实请求。
控制台调试工具汇集了参数、响应和最新价格。
