SERP API
Google、Bing、Naver、百度、Yandex 等 16 个搜索引擎，以及地图、应用商店和 Google Trends，通过一套操作和一个结构提供。
SERP API 按人看到的样子读取搜索引擎。结果页按显示顺序返回：自然结果、广告、新闻、图片、视频、"相关问题"、知识面板、 本地结果和 AI 概览。所有引擎共用一个结构，读取 Google 的代码同样能读取 Naver。
curl "https://gateway.apinoa.com/v1/google/search?q=best+running+shoes&country=US" -H "x-api-key: $APINOA_API_KEY"
curl "https://gateway.apinoa.com/v1/naver/places?q=강남역+카페" -H "x-api-key: $APINOA_API_KEY"
curl "https://gateway.apinoa.com/v1/google-trends/explore?terms=chatgpt,gemini&country=US" -H "x-api-key: $APINOA_API_KEY"操作
| 操作 | 返回 | 读取内容 |
|---|---|---|
search | ResultsPage | 一页结果：用 type 选择网页（默认）、news、images 或 videos。部分引擎还接受 type=image 加 image URL 进行以图搜图 |
suggestions | Suggestions | 搜索框针对 q 给出的联想词 |
places | PlacesPage | 用 q 在地图上找到的地点，范围是 near（地名）或 location（lat,lng）附近 |
place | Place | 单个地点：places 返回的 id，或其地图链接 url |
reviews | PlaceReviewsPage | 地点的评论：place |
应用商店和 Google Trends 使用相同的命名：应用为 search、app 和 reviews，Trends 为 explore 和 trending。
各引擎支持哪些
| search | suggestions | places | place | reviews | 市场 | |
|---|---|---|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ | 10 | ||
| Bing | ✓ | ✓ | 10 | |||
| Yahoo | ✓ | ✓ | 13 | |||
| DuckDuckGo | ✓ | ✓ | 14 | |||
| Yandex | ✓ | ✓ | ✓ | ✓ | ✓ | 10 |
| Naver | ✓ | ✓ | ✓ | ✓ | ✓ | KR |
| Daum | ✓ | ✓ | KR | |||
| Baidu | ✓ | ✓ | CN | |||
| Sogou | ✓ | ✓ | CN | |||
| Yahoo! JAPAN | ✓ | ✓ | JP | |||
| Seznam | ✓ | ✓ | CZ | |||
| Tripadvisor | ✓ | ✓ | ✓ | 15 |
| 操作 | |
|---|---|
| Google Shopping | search product reviews，返回电商平台类型 |
| Google Play · App Store | search app reviews |
| Google Trends | explore trending |
各引擎的页面列出了每个操作在那里接受的输入。
输入
同一个名称在所有引擎上含义相同：
| 输入 | 含义 |
|---|---|
q | 查询，可包含搜索运算符 |
type | 搜索什么：web、news、images、videos（各引擎接受其中一部分） |
country | 市场，ISO 3166 国家代码 |
lang | 界面语言（en、pt-BR） |
device | 读取 desktop 页面（默认）或 mobile 页面 |
timeRange | 只要过去 hour、day、week、month 或 year 内的结果 |
safe | 安全搜索，on 或 off |
near · location | 用于 places：地名或 lat,lng 坐标 |
id · place | 要读取的地点（或应用）；id 也可以用链接 url 代替 |
sort | 评论排序 |
limit | 想要的结果数。超过一页时按页计费 |
cursor | 下一页 |
引擎不接受的输入会以 400 INVALID_PARAMS 拒绝，而不是被忽略。没有按你的要求完成的页面不会收费。
处处相同的部分
- 结构。 每个操作都返回 Response Schema 中的某个类型。只有某个引擎才有的信息放在
ext中。 - 不丢弃任何内容。 页面上的每个区块都按页面顺序连同
rank返回。尚无共享结构的区块以type: "other"返回。 - 分页。 列表会返回一个不透明的
cursor。要取下一页，只带cursor调用同一个操作。没有cursor表示没有下一页。 - 缺失不等于零。 页面没有显示的数量或评分会直接省略，绝不报告为
0。时间为 ISO 8601、UTC。 - 没有结果也是一种回答。
outcome: "noResults"表示引擎说它什么也没找到。无法读取的页面是错误，错误不计费。 - 价格。 每单位 $0.0012。大多数调用为 1 个单位。
limit超过一页时每页 1 个单位，每个操作的页面列出了其价格范围。
错误
SERP API 使用与 API 其他部分相同的响应格式和代码，见 Errors。不存在的地点或应用返回 404 NOT_FOUND，不存在的商品返回 404 PRODUCT_NOT_FOUND，消息中会给出该 id。单个商店的 Google Shopping 商品没有评论，返回 404 REVIEWS_NOT_FOUND。
参考
- Response Schema：每个类型的每个字段
- AI Answers API：ChatGPT、Gemini、Google AI Mode 等，统一为一种回答类型
- Errors：所有错误代码