빠른 답변
SerpCrypto API가 작동하는지 어떻게 확인하나요?
키와 함께 GET https://serpcrypto.com/api/v1/credits을 호출하세요. 무료이며 남은 크레딧을 JSON으로 응답합니다. 200이면 API와 키가 정상 작동한다는 뜻입니다. 502와 504 오류는 검색 실패에서 비롯되며 요금이 부과되지 않습니다. SerpCrypto은 변경 이력에 장애를 게시하며, 측정되기 전까지는 가동률 수치를 공개하지 않습니다.
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"각 응답은 무슨 뜻인가요?
| HTTP 상태 | 의미 | 과금 여부 | 무엇을 해야 하나요 |
|---|---|---|---|
| 200 | API가 작동합니다. 검색의 경우 결과는 본문에 있습니다 | 성공한 검색은 1 크레딧, 크레딧 확인은 무료 | 해당 없음 |
401 invalid_api_key | API 키가 없거나 잘못되었거나 폐기됨 | 아니요 | 대시보드에서 키를 다시 복사하세요 |
402 insufficient_credits | 계정에 남은 크레딧이 없음 | 아니요 | 요금 페이지에서 팩을 구매하세요 |
429 concurrency_limit | 동시에 너무 많은 검색 요청 | 아니요 | 병렬 요청 수를 줄이거나 상한 상향을 요청하세요 |
502 search_failed | 검색을 완료할 수 없었음 | 아니요 | 잠시 기다린 후 재시도하세요 |
504 search_timeout | 제시간에 응답이 없습니다 | 아니요 | 잠시 기다린 후 재시도하세요 |
문제가 제 쪽인가요, 서비스 쪽인가요, 아니면 엔진 쪽인가요?
먼저 무료 점검을 실행하고, 그다음 간단한 검색 하나, 마지막으로 실제 요청을 보내세요. 각 단계가 한 계층씩 분리합니다.
- 크레딧 호출이 401로 실패: 문제는 키입니다. 헤더 형식을 확인하세요:
Authorization: Bearer <key>, 공백 하나를 포함합니다. - 크레딧 호출은 되는데 모든 검색이 502를 반환: 수집 계층이나 엔진이 모든 사용자에게 실패하고 있습니다. 몇 분 기다린 후 재시도하세요. 그동안 요금은 부과되지 않습니다.
- 간단한 쿼리는 되는데 내 쿼리는 400으로 실패: 파라미터가 허용 목록을 벗어났습니다. 검색 레퍼런스에 모든 값이 나열되어 있습니다.
- 결과가 브라우저와 다르게 보임: 보통 위치, 언어 또는 기기 때문입니다. 비교 대상과 맞추려면
gl,hl,location,device을 설정하세요. 위치와 언어를 참고하세요.
장애와 변경 사항은 어디에 게시되나요?
변경 이력에 게시됩니다. 각 항목에는 날짜, 영향받은 대상(엔진, 필드, 고객 영역 또는 결제), 그리고 무엇이 변경되었는지가 있습니다. 새로 추가된 필드도 그곳에 나타나므로, 해당 필드가 필요해지기 전에 파서를 갱신할 수 있습니다.
별도의 상태 사이트는 운영하지 않으며, 이 페이지에는 최신이 아닐 수 있는 초록불도 표시하지 않습니다. 위의 무료 점검이 요청하는 순간의 실제 API 상태를 키 기준으로 알려줍니다.
여기에 가동률 퍼센트가 없는 이유는 무엇인가요?
아직 공개된 방법으로 측정한 적이 없기 때문입니다. 가동률 수치는 정의된 프로브, 정의된 기간, 정의된 실패를 의미합니다. 그것이 갖춰지면 방법과 날짜와 함께 여기에 표시됩니다. 그때까지 정직한 약속은 과금 규칙입니다: 1 크레딧 = 성공한 검색 요청 1건이며, 지원되는 모든 엔진에서 결과 한 페이지를 반환합니다. 실패한 요청은 과금되지 않습니다.
장애 중에 지원팀에 무엇을 보내야 하나요?
search_metadata.id의 요청 ID(응답이 없었다면 요청 시각), 엔진, HTTP 상태, 오류 코드를 [email protected]으로 보내세요. API 키는 절대 포함하지 마세요. 이메일 답변은 연중무휴, 주 7일 12시간 이내에 드리며, API 연동 지원도 포함됩니다. 빠른 답변에 도움이 되는 다른 세부 사항은 문의 페이지에 나열되어 있습니다.