認証

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" }'

キーを取得する

キーはダッシュボードで作成・管理できます。1 つのアカウントで複数のキーを保持でき（例：環境ごとに 1 つ）、いつでもそれらを無効化できます。各キーはプランに由来する独自のレート制限を持ちます。

認証エラー

HTTP	`error`	意味
401	`missing_api_key`	`x-api-key` ヘッダーが送信されませんでした。
401	`unknown_api_key`	キーが存在しません。
403	`inactive_api_key`	キーが無効化されました。
403	`account_blocked`	アカウントが停止されています。

完全なエラーモデルとリトライすべきコードについてはエラーとリトライを参照してください。