无论请求哪种格式,失败时都返回 JSON 错误结构,客户端始终可以先读 status。
输出格式
结果默认是 JSON。设置 format 可以改为 Markdown(适合直接给大模型读),Google 搜索还可以直接拿到结果页 HTML。价格相同。
format
| 取值 | 返回内容 |
|---|---|
json | 默认值。标准外层结构里的解析结果:status、credits_charged、request_id 和结果字段。 |
markdown | 同样的结果,以 Markdown 文本(text/markdown)返回,可以直接交给大模型:没有外层结构、重复字段和内嵌图片。 |
raw | 仅 Google 网页搜索:直接返回结果页 HTML(text/html),已去掉跟踪脚本,结果链接已还原为真实网址。 |
BASH
curl -X POST https://api.serpbase.dev/google/search \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "coffee shops", "format": "markdown"}'