认证

对 POST /v1/search 的每次请求都通过 x-api-key 头部中发送的 API 密钥进行认证。

curl -X POST https://api.serp.cheap/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "q": "coffee makers" }'

获取密钥

在控制台中创建和管理密钥。每个账户可以持有多个密钥（例如每个环境一个），并可随时停用其中任何一个。每个密钥都拥有自己的速率限制，由你的套餐决定。

认证错误

HTTP	`error`	含义
401	`missing_api_key`	未发送 `x-api-key` 头部。
401	`unknown_api_key`	密钥不存在。
403	`inactive_api_key`	密钥已被停用。
403	`account_blocked`	账户已被暂停。

完整的错误模型以及应当重试的错误码，请参见错误与重试。