跳到主要内容

Capzy Data API. 选择数据来源。

找到受支持网站的接口,提交参数并获取 JSON。在这里阅读参考文档,再到控制台调试工具中运行和检查请求。

Amazon 搜索,一目了然

来源 + 操作GET /v1/amazon/search
查询wireless earbuds
响应字段organic_results · 标题、价格、ASIN

示例数据

查找需要的数据来源

每个来源都有各自的端点、必填输入和响应结构。在构建集成之前,请打开其参考文档确认覆盖范围。

所有来源 (83)

发送第一次 Data API 请求

此 Amazon 示例使用来源专属的 GET 端点。HTTP 200 返回来源数据;HTTP 202 返回待处理状态和 jobId。在发送下一个请求之前,请在 Data API 控制台的“运行记录”页面查看待处理的任务。

  1. 创建 Data API 密钥

    打开 Data API 控制台,复制你专属的 Data API 密钥。优先使用套餐额度;额外用量从你共享的 Capzy 账户余额中扣费。

    打开 Data API
  2. 选择来源和操作

    通过网站的参考文档查找请求方法、路径和必填参数。Amazon 搜索示例将 query 和 domain 发送到 /v1/amazon/search。

    查看 Amazon 搜索参数
  3. 在演练场中查看 JSON

    在控制台中打开对应的来源,选择操作,填写输入并运行请求。运行前请查看当前的端点价格。

    打开 Amazon 搜索演练场
amazon_search.py
# 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 的状态封装;请在控制台的“运行记录”页面查看。这个简化的成功响应使用的是示意性商品数据。

response.example.json
{
  "search_information": {
    "query": "wireless earbuds"
  },
  "organic_results": [
    {
      "title": "Example wireless earbuds",
      "price": "$27.99",
      "extracted_price": 27.99,
      "asin": "EXAMPLE001"
    }
  ]
}

organic_results · 标题、价格、ASIN

参数

价格

Data API 套餐包含每月额度。额外用量从你共享的 Capzy 账户余额中扣费。当前端点的额度价格请查看来源参考文档。

正在加载最新价格…

常见问题

演练场在哪里打开?

在“控制台 → Data API → 抓取器”中。来源链接会打开该来源的构建器。端点链接会预先选中对应的操作,让你在运行前查看必填输入。

我可以使用求解器 API 密钥吗?

请使用 Data API 控制台中显示的专属 Data API 密钥。Data API 有自己的套餐控制和内含额度,额外用量则由你共享的 Capzy 账户余额支付。

每个来源都返回相同的 JSON 吗?

不是。每个端点都有来源专属的响应结构。请查看其文档中的响应,并在你的应用中处理缺失或可选字段。

如果某个端点即将推出怎么办?

控制台会标记尚未验证或暂不可运行的端点。请使用那里显示的受支持操作;仅有参考文档条目并不代表端点已经就绪。

找到来源,试一次真实请求。

控制台调试工具汇集了参数、响应和最新价格。

打开调试工具