자연 키워드
API + MCP쿼리 매개변수
수동 타임아웃 시간(초)입니다.
반환할 결과 수입니다.
선택적으로 정렬 방향을 지정할 수 있는, 결과 정렬에 사용할 열의 쉼표로 구분된 목록입니다. 유효한 열 식별자는 응답 스키마를 참고하세요.
필터 표현식입니다. 다음 열 식별자가 인식됩니다(이는 select 파라미터에서 인식되는 식별자와 다릅니다).
best_position: 키워드에 대한 자연 검색 결과에서 대상의 최고 순위입니다.
type: integer nullable
best_position_diff: 선택한 날짜 간 순위 변화입니다.
type: integer nullable
best_position_has_thumbnail: 최고 순위에 썸네일이 있습니다.
type: boolean nullable
best_position_has_thumbnail_prev: 비교 날짜의 최고 순위에 썸네일이 있습니다.
type: boolean nullable
best_position_has_video: 최고 순위에 동영상이 있습니다.
type: boolean nullable
best_position_has_video_prev: 비교 날짜의 최고 순위에 동영상이 있습니다.
type: boolean nullable
best_position_kind: 최고 순위의 유형입니다(자연 검색, 유료, 또는 SERP 기능).
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
best_position_kind_merged: 정렬에 최적화된 최고 순위 유형입니다.
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
best_position_kind_prev: 비교 날짜의 최고 순위 유형입니다.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
best_position_prev: 비교 날짜의 최고 순위입니다.
type: integer nullable
best_position_set: 최고 순위의 순위 그룹입니다.
type: string
enum: "top_3" "top_4_10" "top_11_50" "top_51_more"
best_position_set_prev: 비교 날짜의 최고 순위 순위 그룹입니다.
type: string nullable
enum: "top_3" "top_4_10" "top_11_50" "top_51_more"
best_position_url: 자연 검색 결과에서의 랭킹 URL입니다.
type: string nullable
best_position_url_prev: 비교 날짜의 랭킹 URL입니다.
type: string nullable
best_position_url_raw: 인코딩된 형식의 랭킹 페이지 URL입니다.
type: string nullable
best_position_url_raw_prev: 비교 날짜의 인코딩된 형식 랭킹 페이지 URL입니다.
type: string nullable
cpc: 클릭당 비용은 키워드의 유료 검색 결과에서 광고주가 광고 클릭 1회당 지불하는 평균 비용을 의미하며, USD 센트 단위입니다.
type: integer nullable
cpc_merged: 정렬에 최적화된 클릭당 비용(CPC) 필드입니다.
type: integer nullable
cpc_prev: 비교 날짜의 CPC 지표입니다.
type: integer nullable
entities: 키워드에서 발견된 조직, 제품, 인물, 작품, 이벤트 및 위치입니다.
type: array(object)
event_entities: 키워드에서 발견된 이벤트입니다.
type: array(string)
is_best_position_set_top_11_50: 최고 순위의 순위 그룹이 11~50입니다.
type: boolean
is_best_position_set_top_11_50_prev: 비교 날짜의 최고 순위 순위 그룹이 11~50이었습니다.
type: boolean nullable
is_best_position_set_top_3: 최고 순위의 순위 그룹이 Top 3입니다.
type: boolean
is_best_position_set_top_3_prev: 비교 날짜의 최고 순위 순위 그룹이 Top 3이었습니다.
type: boolean nullable
is_best_position_set_top_4_10: 최고 순위의 순위 그룹이 4~10입니다.
type: boolean
is_best_position_set_top_4_10_prev: 비교 날짜의 최고 순위 순위 그룹이 4~10이었습니다.
type: boolean nullable
is_branded: 사용자 의도: 브랜디드. 사용자가 특정 브랜드 또는 회사명을 검색합니다.
type: boolean
is_commercial: 사용자 의도: 상업적. 사용자가 구매 결정을 내리기 전에 제품 또는 서비스를 비교합니다.
type: boolean
is_informational: 사용자 의도: 정보성. 사용자가 특정 질문에 대한 정보 또는 답을 찾습니다.
type: boolean
is_local: 사용자 의도: 로컬. 사용자가 특정 지역 또는 주변 서비스와 관련된 정보를 찾습니다.
type: boolean
is_main_position: AI 개요, 사이트링크, Top stories, 이미지 팩, 동영상, 토론 및 포럼, 그리고 X(Twitter) 게시물의 순위를 제외합니다.
type: boolean
is_main_position_prev: 비교 날짜에서 AI 개요, 사이트링크, Top stories, 이미지 팩, 동영상, 토론 및 포럼, 그리고 X(Twitter) 게시물의 순위를 제외합니다.
type: boolean
is_navigational: 사용자 의도: 내비게이셔널. 사용자가 특정 웹사이트 또는 웹페이지를 찾습니다.
type: boolean
is_transactional: 사용자 의도: 트랜잭셔널. 사용자가 구매를 포함해 어떤 행동을 완료할 준비가 되어 있습니다.
type: boolean
keyword: 대상이 랭크되는 키워드입니다.
type: string
keyword_country: 대상이 랭크되는 키워드의 국가입니다.
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"
keyword_difficulty (10 units): 키워드에 대해 자연 검색 상위 10위에 랭크되기 얼마나 어려운지의 추정치(100점 척도)입니다.
type: integer nullable
keyword_difficulty_merged (10 units): 정렬에 최적화된 키워드 난이도 필드입니다.
type: integer nullable
keyword_difficulty_prev (10 units): 비교 날짜의 키워드 난이도입니다.
type: integer nullable
keyword_language: 검색 쿼리의 언어입니다.
type: array(string)
keyword_merged: 정렬에 최적화된 키워드 필드입니다.
type: string
keyword_prev: 비교 날짜에 대상이 랭크되던 키워드입니다.
type: string
language: SERP 언어입니다.
type: string
language_prev: 비교 날짜의 SERP 언어입니다.
type: string nullable
last_update: 키워드에 대한 검색 엔진 결과를 마지막으로 확인한 날짜입니다.
type: datetime
last_update_prev: 비교 날짜까지의 검색 엔진 결과를 확인한 날짜입니다.
type: datetime nullable
location_entities: 키워드에서 발견된 위치입니다.
type: array(string)
organisation_entities: 키워드에서 발견된 조직입니다.
type: array(string)
person_entities: 키워드에서 발견된 인물입니다.
type: array(string)
position_kind: 순위의 유형입니다(자연 검색, 유료 또는 SERP 기능). 이는 최고 순위를 선택하기 전, 특정 키워드와 URL에 대한 모든 순위에 적용됩니다.
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
position_kind_prev: 비교 날짜의 순위 유형입니다.
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
positions_kinds: 최고 순위들의 유형입니다.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
positions_kinds_prev: 비교 날짜의 최고 순위 유형입니다.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
product_entities: 키워드에서 발견된 제품입니다.
type: array(string)
serp_features: 키워드의 검색 결과에 나타나는 SERP 기능입니다.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_features_count: 키워드의 검색 결과에 나타나는 SERP 기능의 개수입니다.
type: integer
serp_features_count_prev: 비교 날짜의 SERP 기능 개수입니다.
type: integer nullable
serp_features_merged: 정렬에 최적화된 SERP 기능 필드입니다.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_features_prev: 비교 날짜의 검색 결과에 나타나는 SERP 기능입니다.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_target_main_positions_count: 사이트링크, Top stories, 이미지 팩, X(Twitter) 게시물의 순위를 제외하고, 키워드에 대해 랭크되는 대상 URL의 개수입니다.
type: integer
serp_target_main_positions_count_prev: 비교 날짜에서 사이트링크, Top stories, 이미지 팩, X(Twitter) 게시물의 순위를 제외하고, 키워드에 대해 랭크되는 대상 URL의 개수입니다.
type: integer nullable
serp_target_positions_count: 키워드에 대해 랭크되는 대상 URL의 개수입니다.
type: integer
serp_target_positions_count_prev: 비교 날짜에 키워드에 대해 랭크되는 대상 URL의 개수입니다.
type: integer nullable
status: 페이지 상태입니다. 새로 랭크되기 시작한 페이지("left"), 검색 결과에서 사라진 페이지("right"), 또는 변화 없음("both").
type: string
enum: "left" "right" "both"
sum_paid_traffic (10 units): 키워드의 유료 검색에서 대상이 얻는 추정 월간 방문 수입니다.
type: integer nullable
sum_paid_traffic_merged (10 units): 정렬에 최적화된 유료 트래픽 필드입니다.
type: integer
sum_paid_traffic_prev (10 units): 비교 날짜의 유료 트래픽입니다.
type: integer nullable
sum_traffic (10 units): 키워드의 자연 검색에서 대상이 얻는 추정 월간 방문자 수입니다.
type: integer nullable
sum_traffic_merged (10 units): 정렬에 최적화된 트래픽 필드입니다.
type: integer
sum_traffic_prev (10 units): 비교 날짜의 트래픽입니다.
type: integer nullable
title: 키워드의 SERP에서 페이지에 표시되는 제목입니다.
type: string
title_prev: 비교 날짜의 키워드 SERP에서 페이지에 표시된 제목입니다.
type: string
volume (10 units): 최근 한 달간 키워드의 추정 검색량입니다.
type: integer nullable
volume_desktop_pct: 전체 검색량 중 데스크톱에서 발생한 비율입니다.
type: float nullable
volume_merged (10 units): 정렬에 최적화된 검색량 필드입니다.
type: integer nullable
volume_mobile_pct: 전체 검색량 중 모바일에서 발생한 비율입니다.
type: float nullable
volume_prev (10 units): 비교 날짜의 검색량입니다.
type: integer nullable
words: 키워드의 단어 수입니다.
type: integer
words_merged: 정렬에 최적화된 키워드 단어 수입니다.
type: integer
words_prev: 비교 날짜의 키워드 단어 수입니다.
type: integer
work_entities: 키워드에서 발견된 작품입니다.
type: array(string)
반환할 열 목록(쉼표로 구분)입니다. 유효한 열 식별자는 응답 스키마를 참고하세요.
대상의 프로토콜입니다.
검색 대상: 도메인 또는 URL.
입력한 대상에 따라 검색 범위를 지정합니다.
2자리 국가 코드(ISO 3166-1 alpha-2)입니다.
YYYY-MM-DD 형식으로 비교할 날짜입니다.
지표를 보고할 날짜(YYYY-MM-DD 형식).
검색량 계산 모드: monthly 또는 average. 검색량, 트래픽 및 트래픽 가치에 영향을 줍니다.
출력 형식입니다.
응답
(5단위) 키워드의 전체 순위 목록입니다.
(5개 단위) 비교 날짜에 해당 키워드의 모든 순위 목록입니다.
특정 키워드에 대한 자연 검색 결과에서 타겟 페이지가 기록한 최고 순위입니다.
선택한 날짜 사이의 위치 변화입니다.
최고 순위 결과에 썸네일이 있습니다.
비교 날짜의 최고 순위 결과에 썸네일이 있습니다.
최고 순위 결과에 동영상이 있습니다.
비교 날짜의 최고 순위 결과에 동영상이 있습니다.
최고 순위의 유형: 자연, 유료 또는 SERP 기능입니다.
정렬에 최적화된 최고 순위 유형입니다.
비교 날짜의 최고 순위 유형입니다.
비교 날짜의 최고 순위입니다.
최고 순위의 순위 그룹입니다.
비교 날짜의 최고 순위에 대한 순위 그룹입니다.
자연 검색 결과에서 순위를 차지한 URL입니다.
비교 날짜에 순위를 차지한 URL입니다.
클릭당 비용(CPC)은 키워드의 유료 검색 결과에서 광고주가 광고 클릭 1회당 지불하는 평균 가격을 나타내며, 단위는 미화 센트(USD cents)입니다.
정렬에 최적화된 CPC 필드입니다.
비교 날짜의 CPC 지표입니다.
키워드에서 발견된 조직, 제품, 인물, 저작물, 이벤트 및 위치.
최고 순위의 순위 그룹은 11-50위입니다.
비교 날짜에 최고 순위의 순위 그룹은 11-50위였습니다.
최고 순위의 순위 그룹은 Top 3입니다.
비교 날짜에 최고 순위의 순위 그룹은 Top 3였습니다.
최고 순위의 순위 그룹은 4-10위입니다.
비교 날짜에 최고 순위의 순위 그룹은 4-10위였습니다.
사용자 의도: 브랜드형. 사용자가 특정 브랜드나 회사 이름을 검색하는 경우입니다.
사용자 의도: 상업형. 사용자가 구매 결정을 내리기 전에 제품이나 서비스를 비교·검토하는 검색 의도입니다.
사용자 의도: 정보형. 사용자가 특정 질문에 대한 답이나 정보를 찾고자 합니다.
사용자 의도: 지역형. 사용자가 특정 위치 또는 인근 서비스와 관련된 정보를 찾고자 합니다.
사용자 의도: 탐색형. 사용자가 특정 웹사이트나 웹페이지를 찾기 위해 검색합니다.
사용자 의도: 거래형. 사용자가 구매와 같은 특정 행동을 완료할 준비가 된 상태입니다.
타겟이 순위에 오른 키워드입니다.
타겟이 순위에 오른 키워드의 국가입니다.
(10단위) 키워드 난이도는 특정 키워드로 유기적 검색 결과 상위 10위 안에 들기 얼마나 어려운지를 100점 척도로 추정한 값입니다.
(10단위) 정렬을 위해 최적화된 키워드 난이도 필드입니다.
(10단위) 비교 날짜의 키워드 난이도입니다.
검색 쿼리의 언어
정렬을 위해 최적화된 키워드 필드입니다.
비교 날짜에 타겟이 순위에 오른 키워드입니다.
SERP 언어입니다.
비교 날짜의 SERP 언어입니다.
해당 키워드에 대해 마지막으로 검색 엔진 결과를 확인한 날짜입니다.
비교 날짜까지의 검색 엔진 결과를 확인한 날짜입니다.
키워드의 검색 결과에 표시되는 SERP 기능입니다.
키워드의 검색 결과에 표시되는 SERP 기능의 수입니다.
비교 날짜에 표시된 SERP 기능의 수입니다.
정렬에 최적화된 SERP 기능 필드입니다.
비교 날짜에 키워드의 검색 결과에 표시되는 SERP 기능입니다.
사이트링크, 주요 뉴스, 이미지 팩 및 X(Twitter) 게시물의 순위를 제외한, 키워드에서 순위에 오른 타겟 URL 수입니다.
비교 날짜에 사이트링크, 주요 뉴스, 이미지 팩 및 X(Twitter) 게시물의 순위를 제외하고 키워드에서 순위에 오른 타겟 URL 수입니다.
키워드에서 순위에 오른 타겟 URL 수입니다.
비교 날짜에 키워드에서 순위에 오른 타겟 URL 수입니다.
페이지 상태: 순위를 막 얻기 시작한 새 페이지("left"), 검색 결과에서 사라진 페이지("right"), 또는 변화 없음("both")입니다.
(10 단위) 키워드를 통해 유료 검색에서 타겟 사이트가 얻는 추정 월간 방문 수입니다.
(10 단위) 정렬에 최적화된 유료 트래픽 필드입니다.
(10 units) 비교 날짜의 유료 트래픽입니다.
(10 units) 키워드에 대해 목표 사이트가 자연 검색을 통해 한 달 동안 얻는 추정 방문자 수입니다.
(10 units) 정렬에 최적화된 트래픽 필드입니다.
(10 units) 비교 날짜의 트래픽입니다.
(10 units) 최근 한 달 동안 키워드에 대한 검색 수 추정치입니다.
전체 검색량 중 데스크톱 기기에서 발생한 검색량의 비율입니다.
(10 units) 정렬에 최적화된 검색량 필드입니다.
전체 검색량 중 모바일 기기에서 발생한 검색량의 비율입니다.
(10 units) 비교 날짜의 검색량입니다.
키워드의 단어 수입니다.
정렬에 최적화된 키워드의 단어 수입니다.
비교 날짜의 키워드 단어 수입니다.