일치하는 조건

API + MCP

GET/v3/keywords-explorer/matching-terms

쿼리 매개변수

timeoutinteger

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

limitinteger

반환할 결과 수입니다.

기본:1000

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

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

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필수

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

countrystring필수

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

허용되는 값:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

search_enginestring

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

허용되는 값:google

기본:google

keywordsstring

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

keyword_list_idinteger

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

match_modestring

키워드 아이디어는 쿼리에 포함된 단어가 순서와 무관하게 들어간 경우(terms 모드) 또는 작성된 그대로의 순서로 들어간 경우(phrase 모드)를 포함합니다.

허용되는 값:termsphrase

기본:terms

termsstring

모든 키워드 아이디어 또는 질문형 키워드 아이디어.

허용되는 값:allquestions

기본:all

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

keywordsarray<object>

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위 페이지를 찾아 가장 많은 트래픽을 보내는 키워드를 찾습니다.

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에 포함되지 않을 수 있습니다.