快速开始

1. 注册并创建 API Key

1. 打开 快搜开放平台，用手机号注册（手机号没注册过的，验证码登录会自动注册）。
2. 进 控制台 · API Key，点「创建」。API Key 以 ks_ 开头。
3. 把 API Key 存在服务器端，不要写进网页、App 的前端代码里。

新注册的账号带有赠送余额，可以直接调用；余额在控制台首页看。

2. 发第一个请求

把 YOUR_API_KEY 换成你的 API Key：

curl -X POST https://platform.kuaisou.com/api/web-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"快搜开放平台","count":10}'

Python

import requests

response = requests.post(
    "https://platform.kuaisou.com/api/web-search",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"query": "快搜开放平台", "count": 10},
    timeout=60,
)
data = response.json()
for page in data["data"][0]["webPages"]["value"]:
    print(page["name"], page["url"])

JavaScript（Node.js 18 以上）

const response = await fetch("https://platform.kuaisou.com/api/web-search", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "快搜开放平台", count: 10 }),
});
const data = await response.json();
for (const page of data.data[0].webPages.value) {
  console.log(page.name, page.url);
}

3. 看结果

成功时 HTTP 状态码是 200，返回体里 code 是 200，结果在 data[0].webPages.value 里，每一条有标题 name、链接 url、摘要 snippet。字段的完整说明见 网页搜索。

不成功时看 code 和 msg，见 错误码。失败的调用不扣钱。

不写代码先试一试

控制台里有 体验台：选接口、填搜索词或网址，直接看返回的结果和对应的 curl 写法。体验台不扣余额，每天有次数限制。