Docs
문서 검색...⌘K

깨진 백링크

API + MCP
GET/v3/site-explorer/broken-backlinks

쿼리 매개변수

timeoutinteger

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

limitinteger

반환할 결과 수입니다.

기본:1000
order_bystring

결과를 정렬할 기준 열입니다. 사용 가능한 열 식별자는 응답 스키마를 참고하세요. 단, http_code_target, last_visited_target, link_group_count는 이 엔드포인트에서 order_by로 지원되지 않습니다.

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

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

ahrefs_rank_source: 우리 데이터베이스의 다른 웹사이트와 비교했을 때 참조 도메인의 백링크 프로필 강도이며, #1이 가장 강합니다.
type: integer

ahrefs_rank_target: 우리 데이터베이스의 다른 웹사이트와 비교했을 때 대상 도메인의 백링크 프로필 강도이며, #1이 가장 강합니다.
type: integer

alt: 링크의 alt 속성입니다.
type: string nullable

anchor: URL을 가리키는 링크에서 클릭 가능한 텍스트입니다.
type: string

class_c (5 units): 참조 페이지로 링크되는 고유 class_c 서브넷 수입니다.
type: integer

domain_rating_source: 우리 데이터베이스의 다른 사이트들과 비교했을 때 참조 도메인의 백링크 프로필 강도(100점 척도)입니다.
type: float

domain_rating_target: 우리 데이터베이스의 다른 사이트들과 비교했을 때 대상 도메인의 백링크 프로필 강도(100점 척도)입니다.
type: float

encoding: 참조 페이지 HTML의 문자 인코딩(문자 집합)입니다.
type: string

first_seen: 참조 페이지 URL을 처음 발견한 날짜입니다.
type: datetime

first_seen_link: 특정 참조 페이지에서 대상에 대한 백링크를 처음 발견한 날짜입니다.
type: datetime

http_code: 참조 페이지 크롤링 중 HTTP 프로토콜에서 반환된 상태 코드입니다.
type: integer

http_code_target: 대상 페이지 크롤링 중 HTTP 프로토콜에서 반환된 상태 코드입니다.
type: integer nullable

http_crawl: 자바스크립트를 실행하거나 페이지를 렌더링하지 않고 링크가 발견되었습니다.
type: boolean

ip_source: 참조 도메인의 IP 주소입니다.
type: string nullable

is_alternate: rel=“alternate” 속성이 있는 링크입니다.
type: boolean

is_canonical: rel=“canonical” 속성이 있는 링크입니다.
type: boolean

is_content: 페이지에서 가장 큰 콘텐츠 블록에서 링크가 발견되었습니다.
type: boolean

is_dofollow: 링크에 특별한 nofollow 속성이 없습니다.
type: boolean

is_form: form HTML 태그에서 링크가 발견되었습니다.
type: boolean

is_frame: iframe HTML 태그에서 링크가 발견되었습니다.
type: boolean

is_homepage_link: 참조 웹사이트의 홈페이지에서 링크가 발견되었습니다.
type: boolean

is_image: href 속성 안에 이미지가 포함된 일반 링크입니다.
type: boolean

is_nofollow: 링크 또는 참조 페이지에 nofollow 속성이 설정되어 있습니다.
type: boolean

is_non_html: 링크가 비HTML 콘텐츠의 URL을 가리킵니다.
type: boolean

is_redirect: 리디렉션을 통해 대상으로 연결되는 링크입니다.
type: boolean

is_root_source: 참조 도메인명이 루트 도메인명입니다.
type: boolean

is_root_target: 대상 도메인명이 루트 도메인명입니다.
type: boolean

is_rss: RSS 피드에서 링크가 발견되었습니다.
type: boolean

is_spam: 백링크가 알려진 스팸 도메인에서 왔는지 여부를 나타냅니다.
type: boolean

is_sponsored: 참조 페이지 HTML에 Sponsored 속성이 설정되어 있습니다.
type: boolean

is_text: 링크는 스탠다드 href 하이퍼링크입니다.
type: boolean

is_ugc: 참조 페이지 HTML에 User Generated Content 속성이 설정되어 있습니다.
type: boolean

js_crawl: 자바스크립트를 실행하고 페이지를 렌더링한 후 링크가 발견되었습니다.
type: boolean

languages: 참조 페이지 메타데이터에 표시된 언어 또는 크롤러가 HTML에서 감지한 언어입니다.
type: array(string)

last_seen: 링크가 손실된 것을 발견한 날짜입니다.
type: datetime nullable

last_visited: 백링크가 살아 있는지 확인하기 위해 참조 페이지를 마지막으로 재크롤링한 날짜입니다.
type: datetime

last_visited_target: 대상 페이지가 깨져 있는지 확인하기 위해 대상 페이지를 마지막으로 재크롤링한 날짜입니다.
type: datetime nullable

len_url_redirect: 리디렉션 체인의 URL 개수입니다.
type: integer

link_group_count: 집계(aggregation) 파라미터를 기준으로 함께 그룹화된 백링크 수입니다. 이 필드는 aggregation이 'all'일 때 사용할 수 없습니다.
type: integer

link_type: 백링크의 유형입니다.
type: string
enum: "redirect" "frame" "text" "form" "canonical" "alternate" "rss" "image"

linked_domains_source_domain: 참조 도메인에서 링크된 고유 루트 도메인 수입니다.
type: integer

linked_domains_source_page: 참조 페이지에서 링크된 고유 루트 도메인 수입니다.
type: integer

linked_domains_target_domain: 대상 도메인에서 링크된 고유 루트 도메인 수입니다.
type: integer

links_external: 참조 페이지의 외부 링크 수입니다.
type: integer

links_internal: 참조 페이지의 내부 링크 수입니다.
type: integer

name_source: 하위 도메인을 포함한 전체 참조 도메인명입니다.
type: string

name_target: 하위 도메인을 포함한 전체 대상 도메인명입니다.
type: string

page_category_source: 참조 페이지에 대해 AI가 예측한 계층형 카테고리 경로 목록(쉼표로 구분)입니다. 각 값은 슬래시로 시작하는 경로입니다(예: /Business_and_Industrial/Advertising_and_Marketing/Marketing).
type: string nullable

page_size: 참조 페이지 콘텐츠의 바이트 단위 크기입니다.
type: integer

page_type_source: 참조 페이지에 대해 AI가 예측한 계층형 페이지 유형 경로 목록(쉼표로 구분)입니다. 각 값은 슬래시로 시작하는 경로입니다(예: /Article/How_to).
type: string nullable

port_source: 참조 페이지 URL의 네트워크 포트입니다.
type: integer

port_target: 대상 페이지 URL의 네트워크 포트입니다.
type: integer

positions: 참조 페이지가 상위 100위 안에 랭크되는 키워드 수입니다.
type: integer

positions_source_domain: 참조 도메인이 상위 100위 안에 랭크되는 키워드 수입니다.
type: integer

powered_by: 참조 페이지 콘텐츠를 구성하고 제공하는 데 사용된 웹 기술입니다.
type: array(string)

redirect_code: 리디렉션을 통해 대상으로 연결되는 참조 페이지의 HTTP 상태 코드입니다.
type: integer nullable

redirect_kind: 대상 리디렉션 URL 또는 리디렉션 체인에서 반환된 HTTP 상태 코드입니다.
type: array(integer)

refdomains_source (5 units): 참조 페이지로 링크되는 고유 참조 도메인 수입니다.
type: integer

refdomains_source_domain (5 units): 참조 도메인으로 링크되는 고유 참조 도메인 수입니다.
type: integer

refdomains_target_domain (5 units): 대상 도메인으로 링크되는 고유 참조 도메인 수입니다.
type: integer

root_name_source: 하위 도메인을 제외한 참조 도메인의 루트 도메인명입니다.
type: string

root_name_target: 하위 도메인을 제외한 대상 도메인의 루트 도메인명입니다.
type: string

snippet_left: 링크 바로 앞에 나타나는 텍스트 스니펫입니다.
type: string

snippet_right: 링크 바로 뒤에 나타나는 텍스트 스니펫입니다.
type: string

source_page_author: 참조 페이지의 작성자입니다.
type: string nullable

title: 참조 페이지의 HTML title입니다.
type: string

tld_class_source: 참조 도메인의 최상위 도메인(TLD) 클래스입니다.
type: string
enum: "gov" "edu" "normal"

tld_class_target: 대상 도메인의 최상위 도메인(TLD) 클래스입니다.
type: string
enum: "gov" "edu" "normal"

traffic (10 units): 검색에서 발생한 참조 페이지의 추정 월간 자연 검색 트래픽입니다.
type: integer

traffic_domain (10 units): 검색에서 발생한 참조 도메인의 추정 월간 자연 검색 트래픽입니다.
type: integer

url_from: 대상에 대한 링크가 포함된 페이지의 URL입니다.
type: string

url_from_plain: 필터에서 사용할 수 있도록 최적화된 참조 페이지 URL입니다.
type: string

url_rating_source: 우리 데이터베이스의 다른 페이지들과 비교했을 때 참조 페이지의 백링크 프로필 강도(100점 척도)입니다.
type: float

url_redirect: 링크의 대상 URL이 가리키는 리디렉션 체인입니다.
type: array(url)

url_redirect_with_target: 링크의 대상 URL과 그 리디렉션 체인입니다.
type: array(string)

url_to: 백링크가 가리키는 URL입니다.
type: string

url_to_plain: 필터에서 사용할 수 있도록 최적화된 대상 페이지 URL입니다.
type: string

selectstring필수

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

protocolstring

대상의 프로토콜입니다.

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

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

modestring

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

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

백링크 그룹화 방식입니다.

허용되는 값:similar_links1_per_domainall
기본:similar_links
outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

backlinksarray<object>
ahrefs_rank_sourceinteger

당사 데이터베이스에 있는 다른 웹사이트와 비교한 참조 도메인의 백링크 프로필 강도를 나타내며, 1위가 가장 강력합니다.

ahrefs_rank_targetinteger

당사 데이터베이스에 있는 다른 웹사이트와 비교하여 타겟 도메인의 백링크 프로필 강도를 나타냅니다. 1위는 백링크 프로필 강도가 가장 강력한 웹사이트라는 것을 의미합니다.

altstring or null

링크의 alt 속성입니다.

anchorstring

URL로 연결되는 링크에서 클릭할 수 있는 단어들입니다.

class_cinteger

(5 units) 참조 페이지로 링크를 제공하는 고유 Class C 서브넷 수입니다.

domain_rating_sourcenumber

참조 도메인의 백링크 프로필 강도를 데이터베이스 내 다른 도메인과 비교하여 100점 척도로 나타낸 값입니다.

domain_rating_targetnumber

참조 도메인의 백링크 프로필 강도를 데이터베이스 내 다른 도메인과 비교하여 100점 척도로 나타낸 값입니다.

encodingstring

참조 페이지 HTML의 문자 인코딩입니다.

first_seenstring

참조 페이지 URL이 처음 발견된 날짜입니다.

first_seen_linkstring

지정된 참조 페이지에서 목표 사이트로 연결된 백링크를 처음 발견한 날짜입니다.

http_codeinteger

참조 페이지 크롤링 중 HTTP 프로토콜에서 반환된 상태 코드입니다.

http_code_targetinteger or null

타겟 페이지 크롤링 중 HTTP 프로토콜에서 반환된 응답 코드입니다.

http_crawlboolean

JavaScript를 실행하거나 페이지를 렌더링하지 않고 링크가 발견되었습니다.

ip_sourcestring or null

참조 도메인의 IP 주소입니다.

is_alternateboolean

rel="alternate" 속성이 포함된 링크입니다.

is_canonicalboolean

rel="canonical" 속성이 포함된 링크입니다.

is_contentboolean

링크가 페이지에서 가장 큰 콘텐츠 영역에서 발견되었습니다.

is_dofollowboolean

링크에 노팔로우 속성이 설정되어 있지 않습니다.

is_formboolean

링크가 form HTML 태그에서 발견되었습니다.

is_frameboolean

링크가 iframe HTML 태그에서 발견되었습니다.

is_imageboolean

href 속성 내에 이미지가 포함된 일반 링크입니다.

is_nofollowboolean

링크 또는 참조 페이지에 노팔로우 속성이 설정되어 있습니다.

is_redirectboolean

리디렉션을 통해 타겟에 연결되는 링크입니다.

is_root_sourceboolean

참조 도메인 이름은 루트 도메인 이름입니다.

is_root_targetboolean

대상 도메인 이름은 루트 도메인 이름입니다.

is_rssboolean

링크가 RSS 피드에서 발견되었습니다.

is_spamboolean

백링크가 알려진 스팸 도메인에서 왔는지 여부를 나타냅니다.

is_sponsoredboolean

링크에 참조 페이지 HTML에서 Sponsored 속성이 설정되어 있습니다.

is_textboolean

링크는 표준 href 하이퍼링크입니다.

is_ugcboolean

링크에 참조 페이지 HTML에서 User Generated Content 속성이 설정되어 있습니다.

js_crawlboolean

javascript를 실행하고 페이지를 렌더링한 후 링크가 발견되었습니다.

languagesarray<string>

참조 페이지 메타데이터에 나열되어 있거나 크롤러가 HTML에서 감지한 언어입니다.

last_seenstring or null

링크가 손실된 것으로 확인된 날짜입니다.

last_visitedstring

백링크가 활성 상태인지 확인하기 위해 참조 페이지를 마지막으로 재크롤링한 날짜입니다.

last_visited_targetstring or null

목표 페이지가 손상되었는지 확인하기 위해 마지막으로 재크롤링한 날짜입니다.

link_group_countinteger

집계 매개변수를 기준으로 함께 그룹화된 백링크 수입니다. 이 필드는 'all' 집계와 함께 사용할 수 없습니다.

link_typestring

백링크의 유형입니다.

Allowed values:redirectframetextformcanonicalalternaterssimage
linked_domains_source_domaininteger

참조 도메인에서 링크된 고유 루트 도메인 수입니다.

linked_domains_source_pageinteger

참조 페이지에서 링크된 고유 루트 도메인 수입니다.

linked_domains_target_domaininteger

대상 도메인에서 링크된 고유 루트 도메인 수입니다.

links_externalinteger

참조 페이지의 외부 링크 수입니다.

links_internalinteger

참조 페이지의 내부 링크 수입니다.

name_sourcestring

하위 도메인을 포함한 전체 참조 도메인 이름입니다.

name_targetstring

하위 도메인을 포함한 전체 대상 도메인 이름입니다.

page_category_sourcestring or null

참조 페이지에 대해 AI가 예측한 계층형 카테고리 경로 목록(쉼표로 구분)입니다. 각 값은 슬래시(/)로 시작하는 경로입니다(예: /Business_and_Industrial/Advertising_and_Marketing/Marketing).

page_sizeinteger

참조 페이지 콘텐츠의 바이트 단위 크기입니다.

page_type_sourcestring or null

참조 페이지에 대해 AI가 예측한 계층형 페이지 유형 경로 목록(쉼표로 구분)입니다. 각 값은 슬래시(/)로 시작하는 경로입니다(예: /Article/How_to).

port_sourceinteger

참조 페이지 URL의 네트워크 포트입니다.

port_targetinteger

대상 페이지 URL의 네트워크 포트입니다.

positionsinteger

참조 페이지가 상위 100위 내 순위에 오른 키워드 수입니다.

powered_byarray<string>

참조 페이지 콘텐츠를 구축하고 제공하는 데 사용된 웹 기술입니다.

redirect_codeinteger or null

리디렉션을 통해 대상에 연결되는 참조 페이지의 HTTP 상태 코드입니다.

redirect_kindarray<integer>

대상을 리디렉션하는 URL 또는 리디렉션 체인이 반환한 HTTP 상태 코드입니다.

refdomains_sourceinteger

(5단위) 참조 페이지로 링크를 제공하는 고유 참조 도메인 수입니다.

refdomains_source_domaininteger

(5단위) 참조 도메인으로 링크를 제공하는 고유 참조 도메인 수입니다.

refdomains_target_domaininteger

(5단위) 대상 도메인으로 링크를 제공하는 고유 참조 도메인 수입니다.

root_name_sourcestring

하위 도메인을 제외한 참조 도메인의 루트 도메인 이름입니다.

root_name_targetstring

하위 도메인을 제외한 대상 도메인의 루트 도메인 이름입니다.

snippet_leftstring

링크 바로 앞에 표시되는 텍스트 조각입니다.

snippet_rightstring

링크 바로 뒤에 표시되는 텍스트 조각입니다.

source_page_authorstring or null

참조 페이지의 작성자입니다.

titlestring

참조 페이지의 HTML 제목입니다.

tld_class_sourcestring

참조 도메인의 최상위 도메인(TLD) 클래스입니다.

Allowed values:govedunormal
tld_class_targetstring

타겟 도메인의 최상위 도메인(TLD) 클래스입니다.

Allowed values:govedunormal
trafficinteger

(10 units) 참조 페이지의 검색을 통한 월간 추정 자연 검색 트래픽입니다.

traffic_domaininteger

(10 units) 참조 도메인의 검색을 통한 월간 추정 자연 검색 트래픽입니다.

url_fromstring

타겟으로 연결되는 링크가 포함된 페이지의 URL입니다.

url_from_plainstring

필터로 사용하기에 최적화된 참조 페이지 URL입니다.

url_rating_sourcenumber

참조 페이지의 백링크 프로필 강도를 당사 데이터베이스의 다른 페이지들과 비교해 100점 척도로 나타낸 값입니다.

url_redirectarray<string>

링크의 타겟 URL이 가리키는 리디렉션 체인입니다.

url_redirect_with_targetarray<string>

리디렉션 체인을 포함한 링크의 타겟 URL입니다.

url_tostring

백링크가 가리키는 URL입니다.

url_to_plainstring

필터로 사용하기에 최적화된 타겟 페이지 URL입니다.