인증

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`	계정이 정지되었습니다.

전체 오류 모델과 재시도해야 할 코드는 오류 및 재시도를 참조하세요.