seo/
keyword-search-volume

알고 있는 키워드 최대 1,000개의 검색량, CPC, 유료 경쟁도, 월별 추이를 한 시장 또는 전 세계 범위에서 측정해 정규화된 레코드로 제공합니다.

Keyword Search Volume API

알고 있는 키워드 측정
최대 1,000개 키워드
월별 수요 추이
요청당 24 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

알고 있는 키워드의 한정된 목록을 선택적인 시장·언어 설정과 함께 제출하고, 비동기 결과 레코드에서 정규화된 수요 필드를 읽습니다.

  1. 각각 80자 이하인 비어 있지 않은 알고 있는 키워드 1~1,000개를 준비합니다.
  2. keywords를 /v1/seo/keyword-search-volume으로 POST합니다. 재현 가능한 시장별 요청을 위해 location_code와 language_code를 포함하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Keyword 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와 경쟁도는 자연 검색 순위 난이도가 아니라 유료 검색 신호로 해석하고, 비슷한 변형 키워드가 합산된 검색량을 공유할 수 있다는 점을 고려하세요.

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, 순위, 검색 측정값, 검색 의도, 전체 원본 요소를 포함합니다.

다른 플랫폼 둘러보기

SEO 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Keyword Search Volume API — 자주 묻는 질문

Keyword Search Volume API는 선택한 시장 또는 전 세계 범위에서 알고 있는 키워드 1~1,000개를 측정하는 프로그래밍 인터페이스입니다. 데이터가 있는 키워드마다 확인 가능한 검색량, CPC, 유료 경쟁도, 월별 추이, 원본 행 전체 필드를 반환합니다.

필수인 keywords 배열은 각각 80자 이하인 비어 있지 않은 문자열 1~1,000개를 받습니다. location_code와 language_code는 선택 값이며, 시장과 언어를 생략하면 백엔드는 전 세계 범위를 사용합니다.

행이 없거나 필드가 null이라는 것은 측정 데이터가 없다는 뜻이며, 수요가 0이라는 뜻은 아닐 수 있습니다. 비슷한 변형 키워드는 합산된 검색량 값을 공유하기도 합니다.

아니요. CPC, competition, competition_level, competition_index, 입찰 필드는 유료 검색 맥락을 설명하며, 이 엔드포인트는 자연 검색 키워드 난이도를 계산하지 않습니다.

제출한 요청 1건마다 고정으로 24 SocQ 크레딧이 차감되며, 허용된 일괄 요청 범위 안에서는 키워드 수나 반환된 행 수와 관계가 없습니다.