Docs
문서 검색...⌘K

국가별 볼륨

API + MCP
GET/v3/keywords-explorer/volume-by-country

쿼리 매개변수

selectstring

반환할 필드의 쉼표로 구분된 목록입니다.

order_bystring

결과를 정렬할 필드로, 방향을 선택적으로 지정할 수 있습니다. 형식: field_name:asc 또는 field_name:desc(기본값 desc).

사용 가능한 필드:
  • cpc
  • difficulty (10 units)
  • growth_rate_12m
  • traffic_potential (10 units)
  • volume (10 units)
limitinteger

반환할 결과 수입니다.

offsetinteger

건너뛸 결과의 개수입니다.

기본:0
keyword_list_idinteger

기존 키워드 목록의 ID입니다.

keywordstring

메트릭을 표시할 키워드를 쉼표로 구분한 목록입니다.

countriesstring

두 글자 국가 코드(ISO 3166-1 alpha-2)의 쉼표로 구분된 목록입니다.

허용되는 값:adaeafagaialamaoarasatauawazba…
volume_monthly_date_fromstring (date)

volume_monthly_history 필드에서 과거 월별 검색량을 가져오기 위한 YYYY-MM-DD 형식의 시작 날짜입니다. volume_monthly_history가 요청된 경우에만 필수입니다.

volume_monthly_date_tostring (date)

volume_monthly_history 필드의 과거 월별 검색량을 가져오기 위한 종료 날짜입니다(YYYY-MM-DD 형식). volume_monthly_history를 요청한 경우에만 필수입니다.

outputstring

출력 형식입니다.

허용되는 값:jsonphp

응답

countriesarray<object>
countrystring

두 글자로 된 국가 코드(ISO 3166-1 alpha-2)입니다.

cpcinteger or null

top_keyword의 클릭당 비용이며, 미국 센트 단위입니다.

difficultyinteger or null

(10 units) top_keyword의 키워드 난이도입니다.

growth_rate_12mnumber (float) or null

12개월 검색량 증가율입니다. 단일 키워드 시드에서 사용할 수 있습니다.

has_serpboolean or null

top_keyword에 대한 SERP 데이터 제공 여부입니다.

top_keywordstring or null

이 국가에서 검색량이 가장 높은 시드 키워드입니다.

top_pagestring or null

top_keyword의 최상위 자연 검색 페이지입니다.

top_page_titlestring or null

top_page의 제목입니다.

traffic_potentialinteger or null

(10 units) top_keyword의 트래픽 잠재력입니다.

volumeinteger

(10 units) 특정 국가에서의 키워드 월평균 검색 횟수 추정치입니다.

volume_monthly_historyarray<object>

(50 units) 이 국가에서 시드 키워드 전반에 걸친 월간 검색량을 합산한 값입니다.

datestring (date)
volumeinteger