Uszkodzone linki zwrotne

API + MCP

GET/v3/site-explorer/broken-backlinks

Parametry zapytania

timeoutinteger

Ręcznie ustawiany limit czasu w sekundach.

limitinteger

Liczba wyników do zwrócenia.

Domyślne:1000

order_bystring

Kolumna, według której mają być sortowane wyniki. Prawidłowe identyfikatory kolumn znajdziesz w „Schemat” odpowiedzi, z wyjątkiem http_code_target, last_visited_target, link_group_count, które nie są obsługiwane w order_by dla tego punktu końcowego.

Example:field_a,field_b:asc,field_c:desc

wherestring

Wyrażenie filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się od identyfikatorów rozpoznawanych przez parametr select).

ahrefs_rank_source: Siła profilu linków zwrotnych domeny odsyłającej na tle innych witryn w naszej bazie danych (ranking #1 oznacza najsilniejszy).
typ: integer

ahrefs_rank_target: Siła profilu linków zwrotnych domeny docelowej na tle innych witryn w naszej bazie danych (ranking #1 oznacza najsilniejszy).
typ: integer

alt: Atrybut alt linku.
typ: string nullable

anchor: Kotwice — klikalne słowa w linku, które wskazują adres URL.
typ: string

class_c (5 jednostek): Liczba unikalnych podsieci class_c linkujących do strony odsyłającej.
typ: integer

domain_rating_source: Siła profilu linków zwrotnych domeny odsyłającej na tle innych witryn w naszej bazie danych w skali 0–100.
typ: float

domain_rating_target: Siła profilu linków zwrotnych domeny docelowej na tle innych witryn w naszej bazie danych w skali 0–100.
typ: float

encoding: Kodowanie zestawu znaków HTML strony odsyłającej.
typ: string

first_seen: Data pierwszego wykrycia adresu URL strony odsyłającej.
typ: datetime

first_seen_link: Data, kiedy po raz pierwszy znaleźliśmy link zwrotny do Twojego celu na danej stronie odsyłającej.
typ: datetime

http_code: Kod zwracany przez protokół HTTP podczas indeksowania strony odsyłającej.
typ: integer

http_code_target: Kod zwracany przez protokół HTTP podczas indeksowania strony docelowej.
typ: integer nullable

http_crawl: Link został wykryty bez uruchamiania JavaScriptu i renderowania strony.
typ: boolean

ip_source: Adres IP domeny odsyłającej.
typ: string nullable

is_alternate: Link z atrybutem rel="alternate".
typ: boolean

is_canonical: Link z atrybutem rel="canonical".
typ: boolean

is_content: Link znaleziono w największym bloku treści na stronie.
typ: boolean

is_dofollow: Link nie ma specjalnego atrybutu nofollow.
typ: boolean

is_form: Link znaleziono w znaczniku HTML formularza.
typ: boolean

is_frame: Link znaleziono w znaczniku HTML iframe.
typ: boolean

is_homepage_link: Link znaleziono na stronie głównej witryny odsyłającej.
typ: boolean

is_image: Link jest zwykłym linkiem zawierającym obraz wewnątrz atrybutu href.
typ: boolean

is_nofollow: Link lub strona odsyłająca ma ustawiony atrybut nofollow.
typ: boolean

is_non_html: Link wskazuje adres URL z treścią inną niż HTML.
typ: boolean

is_redirect: Link prowadzi do Twojego celu przez przekierowanie.
typ: boolean

is_root_source: Nazwa domeny odsyłającej jest nazwą domeny głównej (root).
typ: boolean

is_root_target: Nazwa domeny docelowej jest nazwą domeny głównej (root).
typ: boolean

is_rss: Link znaleziono w kanale RSS.
typ: boolean

is_spam: Wskazuje, czy link zwrotny pochodzi ze znanej spamerskiej domeny.
typ: boolean

is_sponsored: Link ma ustawiony atrybut Sponsored w HTML strony odsyłającej.
typ: boolean

is_text: Link jest standardowym hiperłączem href.
typ: boolean

is_ugc: Link ma ustawiony atrybut User Generated Content w HTML strony odsyłającej.
typ: boolean

js_crawl: Link został wykryty po uruchomieniu JavaScriptu i renderowaniu strony.
typ: boolean

languages: Języki podane w metadanych strony odsyłającej lub wykryte przez robota internetowego jako występujące w HTML.
typ: array(string)

last_seen: Data, kiedy wykryliśmy utratę linku.
typ: datetime nullable

last_visited: Data, kiedy ostatnio ponownie sprawdziliśmy stronę odsyłającą, aby potwierdzić, że link zwrotny jest aktywny.
typ: datetime

last_visited_target: Data, kiedy ostatnio ponownie sprawdziliśmy stronę docelową, aby potwierdzić, że jest uszkodzona.
typ: datetime nullable

len_url_redirect: Liczba adresów URL w łańcuchu przekierowań.
typ: integer

link_group_count: Liczba linków zwrotnych pogrupowanych na podstawie parametru agregacji. Tego pola nie można używać z agregacją 'all'.
typ: integer

link_type: Typ linku zwrotnego.
typ: string
enum: "redirect" "frame" "text" "form" "canonical" "alternate" "rss" "image"

linked_domains_source_domain: Liczba unikalnych domen głównych (root) podlinkowanych z domeny odsyłającej.
typ: integer

linked_domains_source_page: Liczba unikalnych domen głównych (root) podlinkowanych ze strony odsyłającej.
typ: integer

linked_domains_target_domain: Liczba unikalnych domen głównych (root) podlinkowanych z domeny docelowej.
typ: integer

links_external: Liczba linków zewnętrznych na stronie odsyłającej.
typ: integer

links_internal: Liczba linków wewnętrznych na stronie odsyłającej.
typ: integer

name_source: Pełna nazwa domeny odsyłającej, łącznie z subdomenami.
typ: string

name_target: Pełna nazwa domeny docelowej, łącznie z subdomenami.
typ: string

page_category_source: Lista ścieżek hierarchicznych kategorii przewidzianych przez AI dla strony odsyłającej, rozdzielonych przecinkami. Każda wartość to ścieżka poprzedzona ukośnikiem (np. /Business_and_Industrial/Advertising_and_Marketing/Marketing).
typ: string nullable

page_size: Rozmiar treści strony odsyłającej w bajtach.
typ: integer

page_type_source: Lista ścieżek hierarchicznych typów stron przewidzianych przez AI dla strony odsyłającej, rozdzielonych przecinkami. Każda wartość to ścieżka poprzedzona ukośnikiem (np. /Article/How_to).
typ: string nullable

port_source: Port sieciowy adresu URL strony odsyłającej.
typ: integer

port_target: Port sieciowy adresu URL strony docelowej.
typ: integer

positions: Liczba słów kluczowych, na które strona odsyłająca rankuje w Top 100.
typ: integer

positions_source_domain: Liczba słów kluczowych, na które domena odsyłająca rankuje w Top 100.
typ: integer

powered_by: Technologie WWW użyte do zbudowania i serwowania treści strony odsyłającej.
typ: array(string)

redirect_code: Kod statusu HTTP strony odsyłającej, która prowadzi do Twojego celu przez przekierowanie.
typ: integer nullable

redirect_kind: Kody statusu HTTP zwracane przez przekierowujący adres URL docelowy lub łańcuch przekierowań.
typ: array(integer)

refdomains_source (5 jednostek): Liczba unikalnych domen odsyłających linkujących do strony odsyłającej.
typ: integer

refdomains_source_domain (5 jednostek): Liczba unikalnych domen odsyłających linkujących do domeny odsyłającej.
typ: integer

refdomains_target_domain (5 jednostek): Liczba unikalnych domen odsyłających linkujących do domeny docelowej.
typ: integer

root_name_source: Nazwa domeny głównej (root) domeny odsyłającej, bez subdomen.
typ: string

root_name_target: Nazwa domeny głównej (root) domeny docelowej, bez subdomen.
typ: string

snippet_left: Fragment tekstu tuż przed linkiem.
typ: string

snippet_right: Fragment tekstu tuż po linku.
typ: string

source_page_author: Autor strony odsyłającej.
typ: string nullable

title: Tytuł HTML strony odsyłającej.
typ: string

tld_class_source: Klasa domeny najwyższego poziomu domeny odsyłającej.
typ: string
enum: "gov" "edu" "normal"

tld_class_target: Klasa domeny najwyższego poziomu domeny docelowej.
typ: string
enum: "gov" "edu" "normal"

traffic (10 jednostek): Szacowany miesięczny ruch organiczny strony odsyłającej z wyszukiwania.
typ: integer

traffic_domain (10 jednostek): Szacowany miesięczny ruch organiczny domeny odsyłającej z wyszukiwania.
typ: integer

url_from: Adres URL strony zawierającej link do Twojego celu.
typ: string

url_from_plain: Adres URL strony odsyłającej zoptymalizowany do użycia jako filtr.
typ: string

url_rating_source: Siła profilu linków zwrotnych strony odsyłającej na tle innych witryn w naszej bazie danych w skali 0–100.
typ: float

url_redirect: Łańcuch przekierowań, do którego prowadzi docelowy adres URL linku.
typ: array(url)

url_redirect_with_target: Docelowy adres URL linku wraz z jego łańcuchem przekierowań.
typ: array(string)

url_to: Adres URL, na który wskazuje link zwrotny.
typ: string

url_to_plain: Adres URL strony docelowej zoptymalizowany do użycia jako filtr.
typ: string

selectstringWymagane

Lista kolumn zwracanych w odpowiedzi, rozdzielona przecinkami. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

protocolstring

Protokół Twojego celu.

Dozwolone wartości:bothhttphttps

Domyślne:both

targetstringWymagane

Cel wyszukiwania: domena lub adres URL.

modestring

Zakres wyszukiwania na podstawie podanego celu.

Dozwolone wartości:exactprefixdomainsubdomains

Domyślne:subdomains

aggregationstring

Tryb grupowania linków zwrotnych.

Dozwolone wartości:similar_links1_per_domainall

Domyślne:similar_links

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

backlinksarray<object>

ahrefs_rank_sourceinteger

Siła profilu linków zwrotnych domeny odsyłającej w porównaniu z innymi witrynami w naszej bazie danych, gdzie pozycja #1 oznacza najsilniejszy profil.

ahrefs_rank_targetinteger

Siła profilu linków zwrotnych domeny docelowej w porównaniu z innymi witrynami w naszej bazie danych, gdzie pozycja #1 oznacza najsilniejszy profil.

altstring or null

Atrybut alt linku.

anchorstring

Klikalne słowa w linku kierujące do adresu URL.

class_cinteger

(5 jednostek) Liczba unikatowych podsieci klasy C (class_c) linkujących do strony odsyłającej.

domain_rating_sourcenumber

Siła profilu linków zwrotnych domeny odsyłającej w porównaniu z innymi w naszej bazie danych w 100-punktowej skali.

domain_rating_targetnumber

Siła profilu linków zwrotnych domeny odsyłającej w porównaniu z innymi w naszej bazie danych w 100-punktowej skali.

encodingstring

Kodowanie zestawu znaków HTML strony odsyłającej.

first_seenstring

Data, kiedy po raz pierwszy wykryto adres URL strony odsyłającej.

first_seen_linkstring

Data pierwszego znalezienia linku zwrotnego do wybranej witryny na danej stronie odsyłającej.

http_codeinteger

Kod odpowiedzi protokołu HTTP zwrócony podczas indeksowania strony odsyłającej.

http_code_targetinteger or null

Kod odpowiedzi protokołu HTTP zwrócony podczas indeksowania strony docelowej.

http_crawlboolean

Link został wykryty bez uruchamiania JavaScript i renderowania strony.

ip_sourcestring or null

Adres IP domeny odsyłającej.

is_alternateboolean

Link z atrybutem rel="alternate".

is_canonicalboolean

Link z atrybutem rel="canonical".

is_contentboolean

Link został znaleziony w największym elemencie treści na stronie.

is_dofollowboolean

Link nie ma specjalnego atrybutu Nofollow.

is_formboolean

Link został znaleziony w znaczniku HTML form.

is_frameboolean

Link został znaleziony w znaczniku HTML iframe.

is_imageboolean

Link jest zwykłym odnośnikiem, którego atrybut href wskazuje na obraz.

is_nofollowboolean

Link lub strona odsyłająca ma ustawiony atrybut Nofollow.

is_redirectboolean

Link kierujący do wybranej witryny przez przekierowanie.

is_root_sourceboolean

Nazwa domeny odsyłającej jest nazwą domeny głównej.

is_root_targetboolean

Docelowa nazwa domeny jest nazwą domeny głównej.

is_rssboolean

Link został znaleziony w kanale RSS.

is_spamboolean

Wskazuje, czy backlink pochodzi z domeny znanej ze spamu.

is_sponsoredboolean

W kodzie HTML strony odsyłającej link ma ustawiony atrybut Sponsored.

is_textboolean

Link jest standardowym hiperłączem href.

is_ugcboolean

W kodzie HTML strony odsyłającej link ma ustawiony atrybut User Generated Content.

js_crawlboolean

Link został wykryty po wykonaniu JavaScriptu i wyrenderowaniu strony.

languagesarray<string>

Języki wymienione w metadanych strony odsyłającej lub wykryte przez robota internetowego jako występujące w HTML.

last_seenstring or null

Data, kiedy odkryliśmy, że link został utracony.

last_visitedstring

Data ostatniego ponownego skanowania strony odsyłającej w celu weryfikacji, czy link zwrotny jest aktywny.

last_visited_targetstring or null

Data ostatniego ponownego skanowania strony docelowej w celu weryfikacji, czy jest uszkodzona.

link_group_countinteger

Liczba linków zwrotnych zgrupowanych na podstawie parametru agregacji. Tego pola nie można używać z agregacją „all".

link_typestring

Rodzaj linku zwrotnego.

Allowed values:redirectframetextformcanonicalalternaterssimage

linked_domains_source_domaininteger

Liczba unikatowych domen głównych, do których prowadzą linki z domeny odsyłającej.

linked_domains_source_pageinteger

Liczba unikatowych domen źródłowych linkowanych ze strony odsyłającej.

linked_domains_target_domaininteger

Liczba unikatowych domen źródłowych linkowanych z domeny docelowej.

links_externalinteger

Liczba linków zewnętrznych ze strony odsyłającej.

links_internalinteger

Liczba linków wewnętrznych ze strony odsyłającej.

name_sourcestring

Pełna nazwa domeny odsyłającej, łącznie z subdomenami.

name_targetstring

Pełna nazwa domeny docelowej, łącznie z subdomenami.

page_category_sourcestring or null

Lista rozdzielonych przecinkami hierarchicznych ścieżek kategorii przewidzianych przez AI dla strony odsyłającej. Każda wartość jest ścieżką z prefiksem ukośnika (np. /Business_and_Industrial/Advertising_and_Marketing/Marketing).

page_sizeinteger

Rozmiar treści strony odsyłającej w bajtach.

page_type_sourcestring or null

Lista rozdzielonych przecinkami hierarchicznych ścieżek typów stron przewidzianych przez AI dla strony odsyłającej. Każda wartość jest ścieżką z prefiksem ukośnika (np. /Article/How_to).

port_sourceinteger

Port sieciowy adresu URL strony odsyłającej.

port_targetinteger

Port sieciowy adresu URL strony docelowej.

positionsinteger

Liczba słów kluczowych w pierwszej setce, na które pozycjonuje się strona odsyłająca.

powered_byarray<string>

Technologie internetowe użyte do zbudowania i serwowania treści strony odsyłającej.

redirect_codeinteger or null

Kod statusu HTTP strony odsyłającej, która wskazuje na cel za pomocą przekierowania.

redirect_kindarray<integer>

Kody stanu HTTP zwracane przez docelowy przekierowujący adres URL lub łańcuch przekierowań.

refdomains_sourceinteger

(5 jednostek) Liczba unikatowych domen odsyłających linkujących do strony odsyłającej.

refdomains_source_domaininteger

(5 jednostek) Liczba unikatowych domen odsyłających linkujących do domeny odsyłającej.

refdomains_target_domaininteger

(5 jednostek) Liczba unikatowych domen odsyłających linkujących do domeny docelowej.

root_name_sourcestring

Nazwa domeny głównej domeny odsyłającej, bez uwzględniania subdomen.

root_name_targetstring

Nazwa domeny głównej domeny docelowej, bez uwzględniania subdomen.

snippet_leftstring

Fragment tekstu pojawiający się bezpośrednio przed linkiem.

snippet_rightstring

Fragment tekstu pojawiający się bezpośrednio po linku.

source_page_authorstring or null

Autor strony odsyłającej.

titlestring

Tytuł HTML strony odsyłającej.

tld_class_sourcestring

Klasa domeny najwyższego poziomu (TLD) domeny odsyłającej.

Allowed values:govedunormal

tld_class_targetstring

Klasa domeny najwyższego poziomu (TLD) domeny docelowej.

Allowed values:govedunormal

trafficinteger

(10 jednostek) Szacowany miesięczny ruch organiczny z wyszukiwarki na stronie odsyłającej.

traffic_domaininteger

(10 jednostek) Szacowany miesięczny ruch organiczny z wyszukiwarki w domenie odsyłającej.

url_fromstring

Adres URL strony zawierającej link do wybranej witryny.

url_from_plainstring

Adres URL strony odsyłającej zoptymalizowany do użycia jako filtr.

url_rating_sourcenumber

Siła profilu linków zwrotnych strony odsyłającej w porównaniu z innymi w naszej bazie danych w 100-punktowej skali.

url_redirectarray<string>

Łańcuch przekierowań, na który wskazuje docelowy adres URL linku.

url_redirect_with_targetarray<string>

Docelowy adres URL linku wraz z jego łańcuchem przekierowań.

url_tostring

Adres URL, na który wskazuje link zwrotny.

url_to_plainstring

Adres URL strony docelowej zoptymalizowany do użycia jako filtr.