검색 제안

API + MCP

GET/v3/keywords-explorer/search-suggestions

쿼리 매개변수

timeoutinteger

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

limitinteger

반환할 결과 수입니다. 최대: 150000.

기본:1000

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

selectstring필수

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

countrystring필수

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

허용되는 값:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

keywordsstring

측정항목을 표시할 키워드의 쉼표로 구분된 목록입니다.

keyword_list_idinteger

측정항목을 표시할 기존 키워드 목록의 ID입니다.

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

keywordsarray<object>

cpcinteger or null

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

cpsnumber (float) or null

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

difficultyinteger or null

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

first_seenstring (date-time) 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 (date-time) or null

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

traffic_potentialinteger or null

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

volumeinteger or null

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

volume_desktop_pctnumber (float) or null

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

volume_mobile_pctnumber (float) or null

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

volume_monthlyinteger or null

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