Linki zwrotne

API + MCP

GET/v3/site-explorer/all-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 link_group_count, który nie jest obsługiwany w order_by dla tego endpointu.

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 Linki zwrotne domeny odsyłającej w porównaniu z innymi witrynami w naszej bazie danych, gdzie pozycja #1 oznacza najsilniejszą.
type: integer

ahrefs_rank_target: Siła profilu Linki zwrotne domeny docelowej w porównaniu z innymi witrynami w naszej bazie danych, gdzie pozycja #1 oznacza najsilniejszą.
type: integer

alt: Atrybut alt linku.
type: string nullable

anchor: Klikalne słowa w linku, które prowadzą do adresu URL.
type: string

broken_redirect_new_target: Nowe miejsce docelowe zmodyfikowanego przekierowania.
type: string nullable

broken_redirect_reason: Powód, dla którego przekierowanie zostało uznane za uszkodzone podczas ostatniego Indeksować.
type: string nullable
enum: "droppedmanual" "droppedtooold" "dropped" "codechanged" "nxdomain" "robotsdisallowed" "curlerror" "invalidtarget" "nomorecanonical" "isnowparked" "targetchanged"

broken_redirect_source: Przekierowujący adres URL, który został zmodyfikowany, przez co przekierowanie stało się uszkodzone.
type: string nullable

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

discovered_status: Powód wykrycia linku podczas ostatniego Indeksować: strona została Indeksować po raz pierwszy, link został dodany do strony lub link pojawił się ponownie po usunięciu.
type: string nullable
enum: "pagefound" "linkfound" "linkrestored"

domain_rating_source: Siła profilu Linki zwrotne domeny odsyłającej w porównaniu z innymi w naszej bazie danych w skali 100 punktów.
type: float

domain_rating_target: Siła profilu Linki zwrotne domeny docelowej w porównaniu z innymi w naszej bazie danych w skali 100 punktów.
type: float

drop_reason: Powód, dla którego usunęliśmy link z naszego indeksu.
type: string nullable
enum: "manual" "noratingunused" "notop" "tooold" "oldunavailable" "rescursive" "duplicate" "nxdomain" "malformed" "blockedport" "disallowed" "unlinked"

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

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

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

http_code: Kod zwrotny protokołu HTTP zwrócony podczas Indeksować strony odsyłającej.
type: integer

http_crawl: Link został wykryty bez uruchamiania JavaScriptu i renderowania strony (w ramach Indeksować).
type: boolean

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

is_alternate: Link z atrybutem rel=“alternate”.
type: boolean

is_canonical: Link z atrybutem rel=“canonical”.
type: boolean

is_content: Link został znaleziony w największym fragmencie treści na stronie.
type: boolean

is_dofollow: Link jest Dofollow (nie ma specjalnego atrybutu Nofollow).
type: boolean

is_form: Link został znaleziony w znaczniku HTML form.
type: boolean

is_frame: Link został znaleziony w znaczniku HTML iframe.
type: boolean

is_homepage_link: Link został znaleziony na stronie głównej witryny odsyłającej.
type: boolean

is_image: Link jest zwykłym linkiem, który zawiera obraz wewnątrz atrybutu href.
type: boolean

is_lost: Link obecnie już nie istnieje.
type: boolean

is_new: Link został wykryty podczas ostatniego Indeksować.
type: boolean

is_nofollow: Link lub strona odsyłająca ma ustawiony atrybut Nofollow.
type: boolean

is_non_html: Link prowadzi do adresu URL z treścią inną niż HTML.
type: boolean

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

is_redirect_lost: Przekierowany link obecnie już nie istnieje.
type: boolean

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

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

is_rss: Link został znaleziony w kanale RSS.
type: boolean

is_spam: Wskazuje, czy Linki zwrotne pochodzą ze znanej domeny spamerskiej.
type: boolean

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

is_text: Link jest hiperłączem href typu Standard.
type: boolean

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

js_crawl: Link został wykryty po uruchomieniu JavaScriptu i wyrenderowaniu strony (w ramach Indeksować).
type: boolean

languages: Języki wymienione w metadanych strony odsyłającej lub wykryte przez Robot internetowy jako występujące w HTML.
type: array(string)

last_seen: Data, kiedy wykryliśmy, że link został utracony.
type: datetime nullable

last_visited: Data, kiedy ostatnio zweryfikowaliśmy Aktywne linki do Twojej strony docelowej.
type: datetime

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

link_group_count: Liczba Linki zwrotne zgrupowanych na podstawie parametru agregacji. Tego pola nie można używać z agregacją 'all'.
type: integer

link_type: Rodzaj Linki zwrotne.
type: 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.
type: integer

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

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

links_external: Liczba linków zewnętrznych ze strony odsyłającej.
type: integer

links_internal: Liczba Linki wewnętrzne ze strony odsyłającej.
type: integer

lost_reason: Powód utraty linku podczas ostatniego Indeksować.
type: string nullable
enum: "removedfromhtml" "notcanonical" "noindex" "pageredirected" "pageerror" "lostredirect" "notfound"

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

name_target: Pełna nazwa domeny docelowej, wraz z subdomenami.
type: string

noindex: Strona odsyłająca ma ustawiony meta atrybut noindex.
type: boolean

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

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

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

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

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

positions: Liczba słów kluczowych, dla których strona odsyłająca zajmuje pozycje w pierwszych 100 wynikach.
type: integer

positions_source_domain: Liczba słów kluczowych, dla których domena odsyłająca zajmuje pozycje w pierwszych 100 wynikach.
type: integer

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

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

redirect_kind: Kody stanu HTTP zwracane przez docelowy adres URL przekierowania lub łańcuch przekierowań.
type: array(integer)

refdomains_source (5 units): Liczba unikalnych Domeny odsyłające linkujących do strony odsyłającej.
type: integer

refdomains_source_domain (5 units): Liczba unikalnych Domeny odsyłające linkujących do domeny odsyłającej.
type: integer

refdomains_target_domain (5 units): Liczba unikalnych Domeny odsyłające linkujących do domeny docelowej.
type: integer

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

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

snippet_left: Fragment tekstu znajdujący się bezpośrednio przed linkiem.
type: string

snippet_right: Fragment tekstu znajdujący się bezpośrednio po linku.
type: string

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

source_page_publish_date: Data, kiedy zidentyfikowaliśmy, że strona została opublikowana.
type: date nullable

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

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

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

traffic (10 units): Szacowany miesięczny Ruch organiczny strony odsyłającej z wyszukiwania.
type: integer

traffic_domain (10 units): Szacowany miesięczny Ruch organiczny domeny odsyłającej z wyszukiwania.
type: integer

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

url_from_plain: Adres URL strony odsyłającej zoptymalizowany pod użycie jako filtr.
type: string

url_rating_source: Siła profilu Linki zwrotne strony odsyłającej w porównaniu z innymi w naszej bazie danych w skali 100 punktów.
type: float

url_redirect: Łańcuch przekierowań, na który wskazuje docelowy adres URL linku.
type: array(url)

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

url_to: Adres URL, na który wskazują Linki zwrotne.
type: string

url_to_plain: Adres URL strony docelowej zoptymalizowany pod użycie jako filtr.
type: 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

historystring

Ramy czasowe dodawania utraconych linków zwrotnych do raportu. Wybierz spośród live (bez historii), since:<date> (historia od podanej daty) oraz all_time (pełna historia). Data powinna mieć format YYYY-MM-DD.

Domyślne:all_time

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.

broken_redirect_new_targetstring or null

Nowy adres docelowy zmodyfikowanego przekierowania.

broken_redirect_reasonstring or null

Powód, dla którego przekierowanie zostało uznane za uszkodzone podczas ostatniego indeksowania.

Allowed values:droppedmanualdroppedtooolddroppedcodechangednxdomainrobotsdisallowedcurlerrorinvalidtargetnomorecanonicalisnowparkedtargetchanged

broken_redirect_sourcestring or null

Adres URL przekierowujący, który został zmodyfikowany, przez co przekierowanie stało się uszkodzone.

class_cinteger

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

discovered_statusstring or null

Powód, dla którego link został wykryty podczas ostatniego indeksowania: strona została zindeksowana po raz pierwszy, link został dodany do strony lub link pojawił się ponownie po jego usunięciu.

Allowed values:pagefoundlinkfoundlinkrestored

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.

drop_reasonstring or null

Powód, dla którego usunęliśmy link z naszego indeksu.

Allowed values:manualnoratingunusednotoptoooldoldunavailablerescursiveduplicatenxdomainmalformedblockedportdisallowedunlinked

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_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_lostboolean

Link obecnie już nie istnieje.

is_newboolean

Link został wykryty podczas ostatniego przeszukiwania.

is_nofollowboolean

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

is_redirectboolean

Link kierujący do wybranej witryny przez przekierowanie.

is_redirect_lostboolean

Przekierowany link obecnie już nie istnieje.

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 ostatniej weryfikacji aktywnego linku do Twojej strony docelowej.

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.

lost_reasonstring or null

Powód, dla którego link został utracony podczas ostatniego indeksowania.

Allowed values:removedfromhtmlnotcanonicalnoindexpageredirectedpageerrorlostredirectnotfound

name_sourcestring

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

name_targetstring

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

noindexboolean

Strona odsyłająca ma atrybut meta noindex.

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.

source_page_publish_datestring or null

data, którą zidentyfikowaliśmy jako datę publikacji strony

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.