Docs
문서 검색...⌘K

자연 키워드

API + MCP
GET/v3/site-explorer/organic-keywords

쿼리 매개변수

timeoutinteger

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

limitinteger

반환할 결과 수입니다.

기본:1000
order_bystring

선택적으로 정렬 방향을 지정할 수 있는, 결과 정렬에 사용할 열의 쉼표로 구분된 목록입니다. 유효한 열 식별자는 응답 스키마를 참고하세요.

Example:field_a,field_b:asc,field_c:desc
wherestring

필터 표현식입니다. 다음 열 식별자가 인식됩니다(이는 select 파라미터에서 인식되는 식별자와 다릅니다).

selectstring필수

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

protocolstring

대상의 프로토콜입니다.

허용되는 값:bothhttphttps
기본:both
targetstring (url)필수

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

modestring

입력한 대상에 따라 검색 범위를 지정합니다.

허용되는 값:exactprefixdomainsubdomains
기본:subdomains
countrystring

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

허용되는 값:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
date_comparedstring (date)

YYYY-MM-DD 형식으로 비교할 날짜입니다.

datestring (date)필수

지표를 보고할 날짜(YYYY-MM-DD 형식).

volume_modestring

검색량 계산 모드: monthly 또는 average. 검색량, 트래픽 및 트래픽 가치에 영향을 줍니다.

허용되는 값:monthlyaverage
기본:monthly
outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

keywordsarray<object>
all_positionsarray<object>

(5단위) 키워드의 전체 순위 목록입니다.

all_positions_prevarray<object>

(5개 단위) 비교 날짜에 해당 키워드의 모든 순위 목록입니다.

best_positioninteger or null

특정 키워드에 대한 자연 검색 결과에서 타겟 페이지가 기록한 최고 순위입니다.

best_position_diffinteger or null

선택한 날짜 사이의 위치 변화입니다.

best_position_has_thumbnailboolean or null

최고 순위 결과에 썸네일이 있습니다.

best_position_has_thumbnail_prevboolean or null

비교 날짜의 최고 순위 결과에 썸네일이 있습니다.

best_position_has_videoboolean or null

최고 순위 결과에 동영상이 있습니다.

best_position_has_video_prevboolean or null

비교 날짜의 최고 순위 결과에 동영상이 있습니다.

best_position_kindstring or null

최고 순위의 유형: 자연, 유료 또는 SERP 기능입니다.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_mergedstring

정렬에 최적화된 최고 순위 유형입니다.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_prevstring or null

비교 날짜의 최고 순위 유형입니다.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_previnteger or null

비교 날짜의 최고 순위입니다.

best_position_setstring

최고 순위의 순위 그룹입니다.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_set_prevstring or null

비교 날짜의 최고 순위에 대한 순위 그룹입니다.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_urlstring (url) or null

자연 검색 결과에서 순위를 차지한 URL입니다.

best_position_url_prevstring (url) or null

비교 날짜에 순위를 차지한 URL입니다.

cpcinteger or null

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

cpc_mergedinteger or null

정렬에 최적화된 CPC 필드입니다.

cpc_previnteger or null

비교 날짜의 CPC 지표입니다.

entitiesarray<object>

키워드에서 발견된 조직, 제품, 인물, 저작물, 이벤트 및 위치.

is_best_position_set_top_11_50boolean

최고 순위의 순위 그룹은 11-50위입니다.

is_best_position_set_top_11_50_prevboolean or null

비교 날짜에 최고 순위의 순위 그룹은 11-50위였습니다.

is_best_position_set_top_3boolean

최고 순위의 순위 그룹은 Top 3입니다.

is_best_position_set_top_3_prevboolean or null

비교 날짜에 최고 순위의 순위 그룹은 Top 3였습니다.

is_best_position_set_top_4_10boolean

최고 순위의 순위 그룹은 4-10위입니다.

is_best_position_set_top_4_10_prevboolean or null

비교 날짜에 최고 순위의 순위 그룹은 4-10위였습니다.

is_brandedboolean

사용자 의도: 브랜드형. 사용자가 특정 브랜드나 회사 이름을 검색하는 경우입니다.

is_commercialboolean

사용자 의도: 상업형. 사용자가 구매 결정을 내리기 전에 제품이나 서비스를 비교·검토하는 검색 의도입니다.

is_informationalboolean

사용자 의도: 정보형. 사용자가 특정 질문에 대한 답이나 정보를 찾고자 합니다.

is_localboolean

사용자 의도: 지역형. 사용자가 특정 위치 또는 인근 서비스와 관련된 정보를 찾고자 합니다.

is_navigationalboolean

사용자 의도: 탐색형. 사용자가 특정 웹사이트나 웹페이지를 찾기 위해 검색합니다.

is_transactionalboolean

사용자 의도: 거래형. 사용자가 구매와 같은 특정 행동을 완료할 준비가 된 상태입니다.

keywordstring or null

타겟이 순위에 오른 키워드입니다.

keyword_countrystring

타겟이 순위에 오른 키워드의 국가입니다.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
keyword_difficultyinteger or null

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

keyword_difficulty_mergedinteger or null

(10단위) 정렬을 위해 최적화된 키워드 난이도 필드입니다.

keyword_difficulty_previnteger or null

(10단위) 비교 날짜의 키워드 난이도입니다.

keyword_languagearray<string>

검색 쿼리의 언어

keyword_mergedstring

정렬을 위해 최적화된 키워드 필드입니다.

keyword_prevstring or null

비교 날짜에 타겟이 순위에 오른 키워드입니다.

languagestring

SERP 언어입니다.

language_prevstring or null

비교 날짜의 SERP 언어입니다.

last_updatestring (date-time)

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

last_update_prevstring (date-time) or null

비교 날짜까지의 검색 엔진 결과를 확인한 날짜입니다.

serp_featuresarray<string>

키워드의 검색 결과에 표시되는 SERP 기능입니다.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_countinteger

키워드의 검색 결과에 표시되는 SERP 기능의 수입니다.

serp_features_count_previnteger or null

비교 날짜에 표시된 SERP 기능의 수입니다.

serp_features_mergedarray<string>

정렬에 최적화된 SERP 기능 필드입니다.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<string>

비교 날짜에 키워드의 검색 결과에 표시되는 SERP 기능입니다.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_target_main_positions_countinteger

사이트링크, 주요 뉴스, 이미지 팩 및 X(Twitter) 게시물의 순위를 제외한, 키워드에서 순위에 오른 타겟 URL 수입니다.

serp_target_main_positions_count_previnteger or null

비교 날짜에 사이트링크, 주요 뉴스, 이미지 팩 및 X(Twitter) 게시물의 순위를 제외하고 키워드에서 순위에 오른 타겟 URL 수입니다.

serp_target_positions_countinteger

키워드에서 순위에 오른 타겟 URL 수입니다.

serp_target_positions_count_previnteger or null

비교 날짜에 키워드에서 순위에 오른 타겟 URL 수입니다.

statusstring

페이지 상태: 순위를 막 얻기 시작한 새 페이지("left"), 검색 결과에서 사라진 페이지("right"), 또는 변화 없음("both")입니다.

Allowed values:leftrightboth
sum_paid_trafficinteger or null

(10 단위) 키워드를 통해 유료 검색에서 타겟 사이트가 얻는 추정 월간 방문 수입니다.

sum_paid_traffic_mergedinteger

(10 단위) 정렬에 최적화된 유료 트래픽 필드입니다.

sum_paid_traffic_previnteger or null

(10 units) 비교 날짜의 유료 트래픽입니다.

sum_trafficinteger or null

(10 units) 키워드에 대해 목표 사이트가 자연 검색을 통해 한 달 동안 얻는 추정 방문자 수입니다.

sum_traffic_mergedinteger

(10 units) 정렬에 최적화된 트래픽 필드입니다.

sum_traffic_previnteger or null

(10 units) 비교 날짜의 트래픽입니다.

volumeinteger or null

(10 units) 최근 한 달 동안 키워드에 대한 검색 수 추정치입니다.

volume_desktop_pctnumber (float) or null

전체 검색량 중 데스크톱 기기에서 발생한 검색량의 비율입니다.

volume_mergedinteger or null

(10 units) 정렬에 최적화된 검색량 필드입니다.

volume_mobile_pctnumber (float) or null

전체 검색량 중 모바일 기기에서 발생한 검색량의 비율입니다.

volume_previnteger or null

(10 units) 비교 날짜의 검색량입니다.

wordsinteger or null

키워드의 단어 수입니다.

words_mergedinteger

정렬에 최적화된 키워드의 단어 수입니다.

words_previnteger or null

비교 날짜의 키워드 단어 수입니다.