结果页上的一切，都是结构化数据
一个 REST API，四个端点。相同的认证方式、相同的响应结构、相同的积分模型。
GET /api/v1/search
自然结果，包含标题、URL、显示链接、摘要、来源和日期。每次调用最多 100 条结果，另附相关搜索。
GET /api/v1/images
原图 URL、缩略图、来源页面和像素尺寸，每次调用最多 150 张。
GET /api/v1/autocomplete
按你选择的语言和市场，获取任意前缀的实时搜索建议。
GET /api/v1/rank
传入关键词和域名，返回该域名在前 100 名中的排名，以及该域名所有上榜的 URL。
定位与分页
每个请求都可控制市场、语言、深度和时效。
| q | 搜索词，最多 400 个字符。支持引号及 site: 等运算符。 |
| gl | 两位字母国家代码。默认为 US。 |
| hl | 界面及结果语言。默认为该国家的主要语言。 |
| num | 每次调用的结果数，10 到 100。每 10 条结果消耗 1 积分。 |
| page | 用于结果分页的页码。 |
| time | 时效筛选：过去一天、一周、一个月或一年。 |
响应字段
每条自然结果包含：
organic_results[0]
{
"position": 1,
"title": "The 15 Best Running Shoes of 2026, Tested by Runner’s World",
"link": "https://www.runnersworld.com/gear/a19663621/best-running-shoes/",
"displayed_link": "https://www.runnersworld.com › gear › best-running-shoes",
"source": "runnersworld.com",
"snippet": "Find the best running shoes of 2026, including Runner’s World-tested picks from Adidas, Brooks, New Balance, Nike, …",
"date": "Aug 3, 2026"
}内置可靠性
- 搜索引擎有时会对自动化流量返回无关结果而不是报错。serpfast 会检查每一页的相关性，并在交付给你之前自动重试。
- 上游失败的请求会自动退还积分，并记录清晰的错误码。
- 速率限制按 API 密钥计算，一个繁忙的集成不会拖慢其他集成。