개요

API + MCP

GET/v3/keywords-explorer/overview

이 요청에서 regex 필터를 사용하면 기능이 제한되며, 문법도 다른 요청과 다릅니다. 와일드카드로 별표(*) 기호를 사용해야 합니다.

쿼리 매개변수

timeoutinteger

수동 타임아웃 시간(초)입니다.

limitinteger

반환할 결과 수입니다.

기본:1000

order_bystring

결과를 정렬할 기준 열입니다. 이 엔드포인트에서 order_by는 volume_monthly를 지원하지 않으므로, 이를 제외한 유효한 열 식별자는 응답 스키마를 참고하세요.

Example:field_a,field_b:asc,field_c:desc

wherestring

필터 표현식입니다. 다음 열 식별자를 인식합니다(이는 select 파라미터가 인식하는 식별자와 다릅니다).

clicks: 사람들이 타깃 키워드를 검색할 때 검색 결과에서 평균적으로 클릭하는 월간 클릭 수입니다.
type: integer nullable

cpc: 클릭당 비용은 유료 검색 결과에서 광고주가 키워드의 광고 클릭 1회당 지불하는 평균 가격을 나타내며, 단위는 USD 센트입니다.
type: integer nullable

cps: 검색당 클릭 수(또는 CPS)는 키워드 검색량 대비 클릭 수 비율입니다. 특정 국가에서 타깃 키워드를 검색할 때 사용자가 평균적으로 몇 개의 서로 다른 검색 결과를 클릭하는지 보여줍니다.
type: float nullable

difficulty (10 units): 100점 척도에서 키워드로 상위 10개 자연 검색 결과에 랭크되기 어려운 정도를 추정한 값입니다.
type: integer nullable

first_seen: 해당 키워드에 대해 처음으로 검색 엔진 결과를 확인한 날짜입니다.
type: datetime nullable

global_volume (10 units): 데이터베이스 내 모든 국가에서 해당 타깃 키워드를 사람들이 월평균 몇 번 검색하는지 나타냅니다.
type: integer nullable

intents (10 units): 사용자의 검색 쿼리 의도를 나타냅니다. 객체 필드: informational, navigational, commercial, transactional, branded 또는 local. 모든 필드는 bool 타입이며, 가능한 값은 true 또는 false입니다.
type: object nullable

keyword:
type: string

parent_topic: 상위 주제는 페이지에서 더 일반적인 주제를 타깃팅하더라도 타깃 키워드로 순위를 올릴 수 있는지 판단합니다. 상위 주제를 식별하기 위해 해당 키워드에서 #1로 랭크된 페이지를 가져와, 그 페이지에 가장 많은 트래픽을 보내는 키워드를 찾습니다.
type: string nullable

parent_volume (10 units): 상위 주제의 검색량입니다.
type: integer nullable

serp_domain_rating_top10_min: 키워드는 DR이 이 값 이하인 결과 중 상위 10위 내 랭킹 포지션을 최소 1개 이상 보유해야 합니다.
type: float nullable

serp_domain_rating_top5_min: 키워드는 DR이 이 값 이하인 결과 중 상위 5위 내 랭킹 포지션을 최소 1개 이상 보유해야 합니다.
type: float nullable

serp_features: 검색 엔진 결과 페이지(SERP)에서 일반적인 자연 검색 결과가 아닌 강화된 결과입니다.
type: array(string)
enum: "ai_overview_sitelink" "snippet" "ai_overview" "local_pack" "sitelink" "news" "image" "video" "discussion" "tweet" "paid_top" "paid_bottom" "paid_sitelink" "shopping" "knowledge_card" "knowledge_panel" "question" "image_th" "video_th" "organic_shopping"

serp_last_update: 해당 키워드에 대해 마지막으로 검색 엔진 결과를 확인한 날짜입니다.
type: datetime nullable

traffic_potential (10 units): 타깃 키워드로 #1에 랭크된 페이지가 순위를 가진 모든 키워드에서 받는 자연 검색 트래픽의 합계입니다.
type: integer nullable

volume (10 units): 최신으로 확인된 12개월 데이터를 기준으로 한 키워드의 평균 월간 검색량 추정치입니다.
type: integer nullable

volume_desktop_pct: 데스크톱 기기에서 수행된 해당 키워드 검색의 비율입니다.
type: float nullable

volume_mobile_pct: 모바일 기기에서 수행된 해당 키워드 검색의 비율입니다.
type: float nullable

word_count:
type: integer

selectstring필수

반환할 열 목록(쉼표로 구분)입니다. 유효한 열 식별자는 응답 스키마를 참고하세요.

volume_monthly_date_tostring

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

volume_monthly_date_fromstring

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

target_modestring

지정한 타깃 URL의 범위입니다.

허용되는 값:exactprefixdomainsubdomains

targetstring

검색 대상: 도메인 또는 URL.

target_positionstring

지정한 target의 순위 위치를 기준으로 키워드를 필터링합니다.

허용되는 값:in_top10in_top100

countrystring필수

2자리 국가 코드(ISO 3166-1 alpha-2)입니다.

허용되는 값:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

search_enginestring

[2024년 8월 5일에 사용 중단됨].

허용되는 값:google

기본:google

keywordsstring

지표를 표시할 키워드의 쉼표로 구분된 목록입니다.

keyword_list_idinteger

지표를 표시할 기존 키워드 목록의 ID입니다.

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

keywordsarray<object>

clicksinteger or null

사람들이 타깃 키워드를 검색할 때 검색 결과에서 평균적으로 클릭하는 월간 클릭 수입니다.

cpcinteger or null

클릭당 비용(CPC)은 키워드의 유료 검색 결과에서 광고주가 광고 클릭 1회당 지불하는 평균 가격을 나타내며, 단위는 미화 센트(USD cents)입니다.

cpsnumber or null

검색당 클릭 수(또는 CPS)는 키워드 검색량 대비 클릭 수 비율을 나타냅니다. 특정 국가에서 타깃 키워드를 검색할 때 사용자가 평균적으로 몇 개의 서로 다른 검색 결과를 클릭하는지 보여줍니다.

difficultyinteger or null

(10단위) 키워드 난이도는 특정 키워드로 유기적 검색 결과 상위 10위 안에 들기 얼마나 어려운지를 100점 척도로 추정한 값입니다.

first_seenstring or null

해당 키워드에 대해 처음으로 검색 엔진 결과를 확인한 날짜입니다.

global_volumeinteger or null

(10 units) 글로벌 검색량은 데이터베이스에 있는 모든 국가에서 목표 키워드가 한 달 동안 평균적으로 검색된 횟수를 보여줍니다.

intentsobject or null

(10 units) 사용자의 검색어 뒤에 있는 검색 목적을 나타냅니다. 객체 필드: informational, navigational, commercial, transactional, branded 또는 local. 모든 필드는 bool 타입이며 가능한 값은 true 또는 false입니다.

keywordstring

parent_topicstring or null

상위 주제는 페이지에서 보다 일반적인 주제를 타겟으로 하면서도 목표 키워드로 순위를 올릴 수 있는지를 결정합니다. 상위 주제를 파악하기 위해 해당 키워드의 1위 페이지를 찾아 가장 많은 트래픽을 보내는 키워드를 찾습니다.

parent_volumeinteger or null

(10 units) 상위 주제의 검색량.

searches_pct_clicks_organic_and_paidnumber or null

목표 키워드를 검색할 때 자연 및 유료 결과를 모두 클릭한 사람의 월평균 비율입니다.

searches_pct_clicks_organic_onlynumber or null

목표 키워드를 검색할 때 자연 결과만 클릭한 사람의 월평균 비율입니다.

searches_pct_clicks_paid_onlynumber or null

목표 키워드를 검색할 때 유료 결과만 클릭한 사람의 월평균 비율입니다.

serp_featuresarray<string>

검색 엔진 결과 페이지(SERP)에서 전통적인 자연 결과가 아닌 강화된 결과들입니다.

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping

serp_last_updatestring or null

해당 키워드에 대해 마지막으로 검색 엔진 결과를 확인한 날짜입니다.

traffic_potentialinteger or null

(10 units) 목표 키워드에서 1위를 차지한 페이지가 순위에 오른 모든 키워드로부터 받는 자연 검색 트래픽의 합입니다.

volumeinteger or null

(10 units) 최근 12개월간의 데이터를 기준으로 키워드의 월평균 검색 횟수를 추정한 값을 보여줍니다.

volume_desktop_pctnumber or null

데스크톱 기기에서 수행된 키워드 검색 비율입니다.

volume_mobile_pctnumber or null

모바일 기기에서 수행된 키워드 검색 비율입니다.

volume_monthlyinteger or null

(10 units) 최근 한 달 동안의 키워드 검색 수 추정치입니다. 이 필드는 order_by parameter에 포함되지 않을 수 있습니다.

volume_monthly_historyarray<object>

(2 units per historical month, with a minimum of 50 units) volume_monthly_date_from 및 volume_monthly_date_to parameters로 설정한 기간에 대한 키워드의 월별 검색량 추정치입니다.