개요
API + MCP이 엔드포인트로의 요청은 무료이며 API 유닛을 소모하지 않습니다.
쿼리 매개변수
수동 타임아웃 시간(초)입니다.
반환할 결과 수입니다.
선택적으로 정렬 방향을 지정할 수 있는, 결과 정렬에 사용할 열의 쉼표로 구분된 목록입니다. 유효한 열 식별자는 응답 스키마를 참고하세요.
필터 표현식입니다. 다음 열 식별자를 인식합니다(이는 select 매개변수가 인식하는 식별자와 다릅니다).
best_position_has_thumbnail: 상위 순위(또는 설정된 경우 타겟 URL)에 썸네일이 있습니다.
type: boolean nullable
best_position_has_thumbnail_previous: 비교 날짜의 상위 순위(또는 설정된 경우 타겟 URL)에 썸네일이 있습니다.
type: boolean nullable
best_position_has_video_preview: 상위 순위(또는 설정된 경우 타겟 URL)에 동영상 미리보기가 있습니다.
type: boolean nullable
best_position_has_video_preview_previous: 비교 날짜의 상위 순위(또는 설정된 경우 타겟 URL)에 동영상 미리보기가 있습니다.
type: boolean nullable
best_position_kind: 상위 순위(또는 설정된 경우 타겟 URL)의 유형: 유기적, 유료 또는 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_previous: 비교 날짜의 상위 순위(또는 설정된 경우 타겟 URL) 유형입니다.
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"
clicks: 클릭 수 지표는 사람들이 타겟 키워드를 검색할 때 검색 결과에서 발생하는 월평균 클릭 수를 의미합니다. 어떤 검색은 여러 결과를 클릭으로 이어지기도 하고, 어떤 검색은 클릭 없이 끝나기도 합니다.
type: integer nullable
clicks_per_search: 검색당 클릭 수는 클릭 수를 키워드 검색량으로 나눈 비율입니다. 특정 국가에서 사람들이 타겟 키워드를 검색할 때 평균적으로 몇 개의 서로 다른 검색 결과가 클릭되는지 보여줍니다.
type: float nullable
cost_per_click: 클릭당 비용은 유료 검색 결과에서 광고주가 키워드의 광고 클릭 1회당 지불하는 평균 비용을 보여줍니다.
type: integer nullable
country: 특정 키워드를 추적하는 국가입니다. 두 글자 국가 코드(ISO 3166-1 alpha-2)입니다.
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"
country_prev: 비교 날짜에 특정 키워드를 추적한 국가입니다. 두 글자 국가 코드(ISO 3166-1 alpha-2)입니다.
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"
created_at: 키워드가 프로젝트에 추가된 날짜입니다.
type: datetime
is_branded: 사용자 의도: 브랜드. 사용자가 특정 브랜드 또는 회사명을 검색하고 있습니다.
type: boolean
is_commercial: 사용자 의도: 상업적. 사용자가 구매 결정을 내리기 전에 제품 또는 서비스를 비교하고 있습니다.
type: boolean
is_informational: 사용자 의도: 정보성. 사용자가 정보 또는 특정 질문에 대한 답을 찾고 있습니다.
type: boolean
is_local: 사용자 의도: 로컬. 사용자가 특정 위치와 관련된 정보 또는 주변 서비스를 찾고 있습니다.
type: boolean
is_main_position: AI 개요, 사이트링크, 주요 뉴스, 이미지 팩, 동영상, 토론 및 포럼, X(트위터) 게시물의 순위를 제외합니다.
type: boolean
is_main_position_prev: 비교 날짜의 AI 개요, 사이트링크, 주요 뉴스, 이미지 팩, 동영상, 토론 및 포럼, X(트위터) 게시물의 순위를 제외합니다.
type: boolean
is_navigational: 사용자 의도: 탐색. 사용자가 특정 웹사이트 또는 웹페이지를 찾고 있습니다.
type: boolean
is_transactional: 사용자 의도: 거래. 사용자가 구매 등 특정 행동을 완료할 준비가 되어 있습니다.
type: boolean
keyword: 타겟이 순위를 얻고 있는 키워드입니다.
type: string
keyword_difficulty: 100점 척도로, 키워드에서 유기적 검색 결과 상위 10위 안에 랭크되기 어려운 정도의 추정치입니다.
type: integer nullable
keyword_has_data: 키워드가 아직 처리 중이며 SERP를 아직 가져오지 않은 경우 false를 반환합니다.
type: boolean
keyword_is_frozen: 키워드가 요금제의 추적 키워드 한도를 초과했는지 여부를 나타냅니다. 이러한 키워드는 "동결"되며, 즉 순위가 업데이트되지 않습니다.
type: boolean
keyword_prev: 비교 날짜에 타겟이 순위를 얻고 있는 키워드입니다.
type: string
keyword_words: 키워드의 단어 수입니다.
type: integer
keyword_words_prev: 비교 날짜의 키워드 단어 수입니다.
type: integer
language: 특정 키워드를 추적하는 SERP 언어입니다.
type: string
language_prev: 비교 날짜의 SERP 언어입니다.
type: string
location: 특정 키워드를 추적하는 위치(국가, 주/도 또는 도시)입니다.
type: string
location_prev: 비교 날짜에 특정 키워드를 추적한 위치(국가, 주/도 또는 도시)입니다.
type: string
parent_topic: 상위 주제는 페이지에서 더 일반적인 주제를 타겟팅하더라도 타겟 키워드로 순위를 얻을 수 있는지 판단합니다. 상위 주제를 식별하기 위해, 해당 키워드에서 1위를 차지한 페이지를 가져와 그 페이지에 가장 많은 트래픽을 보내는 키워드를 찾습니다.
type: string nullable
position: 유기적 검색에서의 상위 순위(또는 설정된 경우 타겟 URL)입니다.
type: integer nullable
position_diff: 선택한 날짜 사이의 상위 순위(또는 설정된 경우 타겟 URL) 변화입니다.
type: integer nullable
position_prev: 비교 날짜의 상위 순위(또는 설정된 경우 타겟 URL)입니다.
type: integer nullable
search_type_image: 검색 유형 Image는 키워드에 대해 이미지로 수행된 검색 비율을 보여주며, 시각적 콘텐츠에 대한 관심을 나타냅니다.
type: float nullable
search_type_news: 검색 유형 News는 키워드에 대해 뉴스 기사로 수행된 검색 비율을 보여줍니다.
type: float nullable
search_type_video: 검색 유형 Video는 키워드에 대해 동영상으로 수행된 검색 비율을 보여주며, 동영상 콘텐츠에 대한 관심을 반영합니다.
type: float nullable
search_type_web: 검색 유형 Web은 키워드에 대해 일반 웹 콘텐츠로 수행된 검색 비율을 보여주며, 다양한 정보에 대한 관심을 나타냅니다.
type: float nullable
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_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_updated: 키워드의 검색 엔진 결과를 마지막으로 확인한 날짜입니다.
type: datetime nullable
serp_updated_prev: 비교 날짜까지의 검색 엔진 결과를 확인한 날짜입니다.
type: datetime nullable
tags: 특정 키워드에 할당된 태그 목록입니다.
type: array(string)
tags_prev: 비교 날짜에 특정 키워드에 할당된 태그 목록입니다.
type: array(string)
target_positions_count: 키워드에 대해 순위를 얻고 있는 타겟 URL의 개수입니다.
type: integer
traffic: "volume_mode" 매개변수에 따라, 최신 1개월 또는 최신(알려진) 12개월 데이터를 기준으로 페이지가 유기적 검색에서 얻는 월간 방문 수 추정치입니다.
type: integer nullable
traffic_diff: 선택한 날짜 사이의 트래픽 변화입니다.
type: integer nullable
traffic_prev: "volume_mode" 매개변수에 따라, 최신 1개월 또는 최신(알려진) 12개월 데이터를 기준으로 페이지가 유기적 검색에서 얻는 월간 방문 수 추정치입니다.
type: integer nullable
url: 유기적 검색에서 가장 높은 순위의 URL(또는 설정된 경우 타겟 URL)입니다.
type: string nullable
url_prev: 비교 날짜의 가장 높은 순위 URL(또는 설정된 경우 타겟 URL)입니다.
type: string nullable
volume: "volume_mode" 매개변수에 따라, 최신 1개월 또는 최신(알려진) 12개월 데이터를 기준으로 한 키워드의 월평균 검색량 추정치입니다.
type: integer nullable
volume_desktop_pct: 전체 검색량 중 데스크톱 기기에서 발생한 비율입니다.
type: float nullable
volume_mobile_pct: 전체 검색량 중 모바일 기기에서 발생한 비율입니다.
type: float nullable
반환할 열 목록(쉼표로 구분)입니다. 유효한 열 식별자는 응답 스키마를 참고하세요.
YYYY-MM-DD 형식으로 비교할 날짜입니다.
지표를 보고할 날짜(YYYY-MM-DD 형식).
모바일 순위와 데스크톱 순위 중에서 선택합니다.
프로젝트의 고유 식별자입니다. Ahrefs에서 순위 트래커 프로젝트의 URL에서 확인할 수 있습니다: https://app.ahrefs.com/rank-tracker/overview/#project_id#
검색량 계산 모드: monthly 또는 average. 검색량, 트래픽 및 트래픽 가치에 영향을 줍니다.
출력 형식입니다.
응답
상위 순위(또는 설정된 경우 타겟 URL)에 썸네일이 있습니다.
비교 날짜의 상위 순위(또는 설정된 경우 타겟 URL)에 썸네일이 있습니다.
상위 순위(또는 설정된 경우 타겟 URL)에 동영상 미리보기가 있습니다.
비교 날짜의 상위 순위(또는 설정된 경우 타겟 URL)에 동영상 미리보기가 있습니다.
상위 순위(또는 설정된 경우 타겟 URL)의 유형: 유기적, 유료 또는 SERP 기능.
비교 날짜 기준의 최고 순위 유형(설정된 경우 대상 URL의 순위 유형)입니다.
클릭 수 지표는 사용자가 목표 키워드를 검색할 때, 검색 결과를 클릭하는 월평균 횟수를 의미합니다. 검색자가 결과를 클릭하지 않는 경우도 있고 여러 번 클릭할 수도 있기 때문에 검색 수와는 차이가 있을 수 있습니다.
검색당 클릭 수는 키워드 검색량 대비 클릭 비율을 나타냅니다. 특정 국가에서 해당 키워드 검색 시 사용자가 평균적으로 몇 개의 검색결과를 클릭하는지 보여줍니다.
클릭당 비용은 키워드에 대한 유료 검색 결과에서 광고주가 각 광고 클릭에 지불하는 평균 가격을 보여줍니다.
지정된 키워드가 추적되고 있는 국가입니다. 두 글자 국가 코드(ISO 3166-1 alpha-2)입니다.
비교 날짜에 지정된 키워드가 추적되고 있는 국가입니다. 두 글자 국가 코드(ISO 3166-1 alpha-2)입니다.
프로젝트에 키워드가 추가된 날짜입니다.
사용자 의도: 브랜드형. 사용자가 특정 브랜드나 회사 이름을 검색하는 경우입니다.
사용자 의도: 상업형. 사용자가 구매 결정을 내리기 전에 제품이나 서비스를 비교·검토하는 검색 의도입니다.
사용자 의도: 정보형. 사용자가 특정 질문에 대한 답이나 정보를 찾고자 합니다.
사용자 의도: 지역형. 사용자가 특정 위치 또는 인근 서비스와 관련된 정보를 찾고자 합니다.
사용자 의도: 탐색형. 사용자가 특정 웹사이트나 웹페이지를 찾기 위해 검색합니다.
사용자 의도: 거래형. 사용자가 구매와 같은 특정 행동을 완료할 준비가 된 상태입니다.
타겟이 순위에 오른 키워드입니다.
키워드 난이도는 특정 키워드로 유기적 검색 결과 상위 10위 안에 들기 얼마나 어려운지를 100점 척도로 추정한 값입니다.
키워드가 아직 처리 중이며 SERP를 아직 가져오지 않았다면 false를 반환합니다.
키워드가 요금제의 추적 키워드 한도를 초과했는지 여부를 나타냅니다. 이러한 키워드는 "동결"되어 순위가 업데이트되지 않습니다.
비교 날짜에 타겟이 순위에 오른 키워드입니다.
지정된 키워드를 추적하는 SERP 언어입니다.
비교 날짜의 SERP 언어입니다.
지정된 키워드가 추적되고 있는 특정 위치(국가, 주/도, 또는 도시)입니다.
비교 날짜에 지정된 키워드가 추적되고 있는 위치(국가, 주/도 또는 도시)입니다.
상위 주제는 페이지에서 보다 일반적인 주제를 타겟으로 하는 동안 목표 키워드로 1위 랭크할 수 있는지를 결정합니다. 상위 주제를 파악하기 위해 키워드에 대한 1위 페이지를 찾아 가장 많은 트래픽을 유도하는 키워드를 찾습니다.
유기적 검색에서의 최고 순위(설정된 경우 대상 URL의 순위)입니다.
선택한 날짜 사이의 최고 순위(설정된 경우 대상 URL의 순위) 변화입니다.
비교 날짜 기준의 최고 순위(설정된 경우 대상 URL의 순위)입니다.
검색 유형 이미지는 키워드에 대해 이미지가 검색된 비율을 보여주며, 비주얼 콘텐츠에 대한 관심을 강조합니다.
검색 유형 "뉴스"는 해당 키워드가 뉴스 검색에서 차지하는 비율을 나타냅니다.
검색 유형 비디오는 비디오 콘텐츠에 대한 관심을 반영하여 비디오를 위해 이루어진 키워드 검색의 비율을 보여줍니다.
웹 검색 유형은 특정 키워드에 대해 일반 웹 검색에서 발생한 검색 비율을 나타냅니다. 이는 해당 키워드가 가진 일반적인 관심도의 지표입니다.
키워드의 검색 결과에 표시되는 SERP 기능입니다.
비교 날짜에 키워드의 검색 결과에 표시되는 SERP 기능입니다.
해당 키워드에 대해 마지막으로 검색 엔진 결과를 확인한 날짜입니다.
비교 날짜까지의 검색 엔진 결과를 확인한 날짜입니다.
특정 키워드에 할당된 태그 목록입니다.
비교 날짜에 해당 키워드에 할당된 태그 목록입니다.
키워드에서 순위에 오른 타겟 URL 수입니다.
"volume_mode" 매개변수에 따라 최근 1개월 또는 확인 가능한 최근 12개월 데이터 기준으로, 페이지가 자연 검색에서 얻는 월간 방문 수를 추정한 값입니다.
선택한 날짜 사이의 트래픽 변화입니다.
"volume_mode" 매개변수에 따라 최근 1개월 또는 확인 가능한 최근 12개월 데이터 기준으로, 페이지가 자연 검색에서 얻는 월간 방문 수를 추정한 값입니다.
자연 검색에서 가장 상위에 노출되는 URL(또는 설정된 경우 타깃 URL)입니다.
비교 날짜에 가장 상위에 노출되는 URL(또는 설정된 경우 타깃 URL)입니다.
"volume_mode" 매개변수에 따라 최근 1개월 또는 확인 가능한 최근 12개월 데이터 기준으로 키워드의 월평균 검색 횟수를 추정한 값입니다.
전체 검색량 중 데스크톱 기기에서 발생한 검색량의 비율입니다.
전체 검색량 중 모바일 기기에서 발생한 검색량의 비율입니다.