Keyword Search Volume
키워드 검색량 레코드는 알고 있는 검색어에 선택한 시장 또는 전 세계 검색 환경의 추정 수요, CPC, 유료 경쟁도, 월별 관측값을 짝지어 보여 줍니다. 이러한 측정값은 수요 비교, 계절성 검토, 유료 시장 리서치, 키워드 목록 정보 보강에 활용할 수 있습니다.
Keyword Search Volume API 주요 기능
- 알고 있는 키워드 일괄 측정한 번의 요청으로 준비한 키워드 1~1,000개를 측정하며, 입력 하나는 80자로 제한됩니다.
- 검색 수요 필드측정 데이터가 있는 키워드마다 확인 가능한 search_volume 값과 monthly_searches 관측값을 반환합니다.
- 유료 시장 맥락확인 가능한 CPC, 경쟁도, 경쟁 수준, 경쟁 지수, 선택적 입찰 필드를 측정한 검색어에 연결된 상태로 유지합니다.
- 원본 맥락을 갖춘 정규화 레코드안정적인 수요 필드는 metrics로 승격하고, 선택적인 시장·입찰 메타데이터를 위해 반환된 행 전체를 extra에 보존합니다.
Keyword Search Volume API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
keywords | 필수 | 알고 있는 비어 있지 않은 키워드 1~1,000개의 목록으로, 필수 값입니다. 항목당 최대 80자까지 사용할 수 있습니다. |
location_code | 선택 | 양의 정수인 검색 시장 코드이며 선택 값입니다. 플레이그라운드는 미국을 뜻하는 2840을 명시적으로 보냅니다. 이 필드를 language_code와 함께 비우면 백엔드의 전 세계 범위가 사용됩니다. |
location_name | 선택 | location_code 대신 쓸 수 있는 검색 시장 이름으로, 선택 값입니다. 입력하면 location_code보다 우선합니다. |
language_code | 선택 | 길이 2~10자의 검색 언어 코드이며 선택 값입니다. 플레이그라운드는 en을 명시적으로 보냅니다. 이 필드를 location_code와 함께 비우면 백엔드의 전 세계 범위가 사용됩니다. |
language | 선택 | language_code 대신 쓸 수 있는 검색 언어 이름으로, 선택 값입니다. 입력하면 language_code보다 우선합니다. |
results_limit | 선택 | 1에서 2,000 사이의 결과 수 제한으로, 선택 값입니다. |
Keyword Search Volume API 사용 방법
알고 있는 키워드의 한정된 목록을 선택적인 시장·언어 설정과 함께 제출하고, 비동기 결과 레코드에서 정규화된 수요 필드를 읽습니다.
- 각각 80자 이하인 비어 있지 않은 알고 있는 키워드 1~1,000개를 준비합니다.
- keywords를 /v1/seo/keyword-search-volume으로 POST합니다. 재현 가능한 시장별 요청을 위해 location_code와 language_code를 포함하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고 has_more가 true인 동안 next_cursor를 따라갑니다. 승격되지 않은 원본 필드는 extra에서 확인합니다.
curl -X POST "https://api.socq.ai/v1/seo/keyword-search-volume" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords":["keyword research","seo tools"],"location_code":2840,"language_code":"en"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueKeyword Search Volume API 추천 활용 사례
- 준비한 목록의 수요 비교: 알고 있는 키워드 목록에 search_volume 값을 결합해, 일관된 검색 환경 안에서 추정 수요를 비교합니다.
- 월별 계절성 검토: year, month, search_volume 관측값을 활용해 측정된 수요가 시간에 따라 어떻게 변하는지 살펴봅니다.
- 유료 검색 환경 리서치: 측정한 키워드 전반에서 CPC, 경쟁도, 경쟁 지수, 선택적 입찰 정보를 비교합니다.
Keyword Search Volume API 활용 팁
- 고정 24 크레딧 요금은 반환된 행마다가 아니라 요청 단위로 적용되므로, 가능하면 준비한 키워드를 개수 제한 안에서 한 번에 묶어 보내세요.
- 배치끼리 비교할 때는 location_code와 language_code를 명시하고 바꾸지 마세요. 전 세계 범위를 의도한 경우에만 둘 다 생략하세요.
- 이 작업은 keywords 배열로 일괄 요청이 제어되고 문서화된 제한 제어가 없으므로 results_limit은 제출하지 마세요.
- 반환된 행은 키워드로 대응시키고, 누락된 레코드나 null 필드는 수요가 0으로 확인된 것이 아니라 확인할 수 없는 데이터로 취급하세요.
- CPC와 경쟁도는 자연 검색 순위 난이도가 아니라 유료 검색 신호로 해석하고, 비슷한 변형 키워드가 합산된 검색량을 공유할 수 있다는 점을 고려하세요.
관련 API
Keyword Search Volume API 외에 SEO의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Google Organic SERP API — 검색어와 시장으로 실시간 Google 검색 결과 페이지 하나를 가져오며, 정규화된 도착 URL, 순위, 요소 유형, 전체 결과 상세를 포함합니다.
- Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
- Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
- Keywords for Site API — 웹사이트 하나와 관련된 키워드를 생성하며, 확인 가능한 수요 측정값, 월별 추이, 시장 맥락, 전체 원본 행을 포함합니다.
- Keyword Suggestions API — 시드 검색어 하나를 일치하는 롱테일 키워드로 확장하며, 확인 가능한 수요 측정값, 월별 추이, 검색 의도 맥락, 전체 원본 행을 포함합니다.
- Ranked Keywords API — 도메인, 서브도메인, 페이지가 순위에 오른 키워드를 찾으며, 해당 URL, 순위, 검색 측정값, 검색 의도, 전체 원본 요소를 포함합니다.
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API