검색 결과 30개를 요청했는데 왜 9개만 왔을까?

상용 SERP API가 num=30 요청을 정상 처리한 것처럼 응답했지만 실제 결과는 9건뿐이었습니다. 2026-08-19 실측에서 num=10, num=30, num=100은 모두 9건을 반환했고 호출당 크레딧 1은 그대로 차감됐습니다. 다음 페이지를 직접 요청해 10건을 더 확보하자, 인용 출처 겹침률은 65%에서 94%로 바뀌었습니다.

정상 응답인데 왜 실패일까?

이 사례의 문제는 오류 코드가 없었다는 데 있습니다. API는 요청한 결과 개수를 반영하지 않고도 정상 응답을 돌려줬습니다. 수집기는 응답 성공 여부만 확인했기 때문에 부족한 결과를 완료로 기록했습니다.

페이지당 반환량은 요청값과 무관하게 7~10건에 머물렀습니다. 결과 깊이는 개수 파라미터가 아니라 페이지 파라미터로만 늘어났습니다.

어떻게 검증했나?

동일한 질의에서 결과 개수 파라미터만 바꿔 num=10, num=30, num=100을 순서대로 호출했습니다. 모든 호출의 organic 배열 길이와 가장 큰 position 값을 대조했습니다. 요청값은 달랐지만 반환량은 모두 9건이었습니다.

그다음 page=2를 보내 10건을 추가로 받았습니다. 개수를 늘리는 요청과 페이지를 넘기는 요청을 분리해 재현한 것입니다.

요청	반환 결과	확인한 상태
num=10	9건	정상 응답, 크레딧 1 차감
num=30	9건	정상 응답, 크레딧 1 차감
num=100	9건	정상 응답, 크레딧 1 차감
page=2	10건 추가	검색 깊이 확장

요청 문자열만 남겨서는 이 실패를 재구성할 수 없습니다. 응답 배열의 길이와 position 범위가 함께 있어야 요청값이 적용됐는지 판정할 수 있습니다. 비용이 차감됐다는 사실도 결과 범위가 충분했다는 근거가 되지 않습니다.

검색 깊이가 지표를 얼마나 바꾸었나?

처음에는 상위 30을 요청했다고 믿고 인용 출처와의 겹침률을 65%로 계산했습니다. 페이지네이션으로 검색 깊이를 확보한 뒤 다시 계산한 겹침률은 94%였습니다. 처음 수치는 29%p 낮았습니다.

이 차이는 분석 공식이 바뀌 결과가 아닙니다. 검색 결과를 요청한 범위까지 받지 못해 분모가 달라진 결과입니다. 수집 누락을 출처 불일치로 잘못 해석할 수 있는 구조였습니다.

빈 결과를 부재의 증거로 봐도 될까?

안 됩니다. 이 실측에서 반환량이 작았던 이유는 검색 결과가 없었기 때문이 아니라 API가 개수 파라미터를 반영하지 않았기 때문입니다. 빈 결과와 잘린 결과를 같은 상태로 저장하면 후속 분석은 어느 쪽이었는지 구분할 수 없습니다.

같은 작업에서 존재하는 API 키를 없다고 보고한 경우와 정상 검색을 없다고 기록한 경우도 함께 발견됐습니다. 검색 패턴이 값을 볼 수 없는 형태였고, 수집 스크립트는 오류 응답을 삼켰습니다. 공통원인은 빈 값이 나온 경로를 확인하지 않고 실제 부재로 해석한 것이었습니다.

수집기는 무엇을 기록해야 할까?

성공 코드와 함께 요청한 개수, 실제 반환 개수, 최대 position을 남겨야 합니다. 요청 범위와 응답 범위가 다르면 다음 페이지를 가져오는 규칙이 작동해야 합니다. 응답이 빈 경우와 응답이 잘린 경우도 다른 상태로 보관해야 합니다.

인트릭스는 검색 결과 수집 로그에서 페이지 깊이와 반환량을 함께 확인합니다. 무료 SEO·GEO 진단은 사이트의 현재 상태를 실제 요청으로 확인하고, 해석에 쓴 모집단과 수집 범위를 분리해 제시합니다.

이 결과를 어디까지 적용할 수 있나?

실측 모집단은 상용 SERP API 1종이었습니다. 한국어 지역 서비스업 질의 4건과 영문 일반 질의 1건을 확인했습니다. 다른 API와 다른 질의에서도 같은 반환 제한이 있다고 일반화할 수는 없습니다.

다만 검증 원칙은 그대로 적용할 수 있습니다. API가 요청을 받았다는 사실과 요청대로 응답했다는 사실은 같지 않습니다. 응답 크기와 범위를 로그로 대조해야 조용한 누락을 잡을 수 있습니다.

자주 묻는 질문

Q. num=30을 보내면 30건을 받았다고 봐도 되나요?
안 됩니다. 이 실측에서는 num=30이 정상 응답을 받았지만 organic 결과는 9건이었습니다. 응답 배열 길이와 최대 position을 따로 확인해야 합니다.

Q. 결과를 더 얻으려면 무엇을 바꿔야 하나요?
이 API에서는 결과 개수 파라미터가 아니라 페이지 파라미터로 깊이를 확보했습니다. page=2를 요청했을 때 10건이 추가로 반환됐습니다.

Q. 이 누락이 분석 결과에 실제로 영향을 줬나요?
그렇습니다. 인용 출처 겹침률은 페이지네이션 전 65%에서 후 94%로 바뀌었고, 처음 수치는 29%p 낮았습니다.