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).

selectstringWymagane

Lista kolumn do zwrócenia, rozdzielona przecinkami. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

protocolstring

Protokół Twojego celu.

Dozwolone wartości:bothhttphttps

Domyślne:both

targetstring (url)Wymagane

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 (float)

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 (float)

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 (date-time)

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

first_seen_linkstring (date-time)

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 (date-time) or null

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

last_visitedstring (date-time)

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 (date) 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 (url)

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 (float)

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 (url)>

Ł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 (url)

Adres URL, na który wskazuje link zwrotny.

url_to_plainstring

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