Backlink

API + MCP

GET/v3/site-explorer/all-backlinks

Parametri della query

timeoutinteger

Una durata di timeout manuale in secondi.

limitinteger

Il numero di risultati da restituire.

Predefinita:1000

order_bystring

Una colonna per ordinare i risultati. Consulta lo Schema di risposta per gli identificatori di colonna validi, ad eccezione di link_group_count, che non è supportato in order_by per questo endpoint.

Example:field_a,field_b:asc,field_c:desc

wherestring

L'espressione di filtro. Sono riconosciuti i seguenti identificatori di colonna (questi differiscono dagli identificatori riconosciuti dal parametro select).

ahrefs_rank_source: La forza del profilo di backlink del dominio di provenienza rispetto agli altri siti web nel nostro database, con il rank #1 come il più forte.
type: integer

ahrefs_rank_target: La forza del profilo di backlink del dominio target rispetto agli altri siti web nel nostro database, con il rank #1 come il più forte.
type: integer

alt: L'attributo alt del link.
type: string nullable

anchor: Le parole cliccabili in un link che puntano a un URL.
type: string

broken_redirect_new_target: La nuova destinazione di un reindirizzamento modificato.
type: string nullable

broken_redirect_reason: Il motivo per cui il reindirizzamento è stato considerato non valido durante l'ultima scansione.
type: string nullable
enum: "droppedmanual" "droppedtooold" "dropped" "codechanged" "nxdomain" "robotsdisallowed" "curlerror" "invalidtarget" "nomorecanonical" "isnowparked" "targetchanged"

broken_redirect_source: L'URL che reindirizza e che è stato modificato, causando la rottura del reindirizzamento.
type: string nullable

class_c (5 units): Il numero di subnet class_c uniche che si collegano alla pagina di provenienza.
type: integer

discovered_status: Il motivo per cui il link è stato individuato durante l'ultima scansione: la pagina è stata scansionata per la prima volta, il link è stato aggiunto alla pagina oppure il link è riapparso dopo essere stato rimosso.
type: string nullable
enum: "pagefound" "linkfound" "linkrestored"

domain_rating_source: La forza del profilo di backlink del dominio di provenienza rispetto agli altri nel nostro database su una scala di 100 punti.
type: float

domain_rating_target: La forza del profilo di backlink del dominio target rispetto agli altri nel nostro database su una scala di 100 punti.
type: float

drop_reason: Il motivo per cui abbiamo rimosso il link dal nostro indice.
type: string nullable
enum: "manual" "noratingunused" "notop" "tooold" "oldunavailable" "rescursive" "duplicate" "nxdomain" "malformed" "blockedport" "disallowed" "unlinked"

encoding: La codifica del set di caratteri dell'HTML della pagina di provenienza.
type: string

first_seen: La data in cui l'URL della pagina di provenienza è stato individuato per la prima volta.
type: datetime

first_seen_link: La data in cui abbiamo trovato per la prima volta un backlink verso il tuo target in una determinata pagina di provenienza.
type: datetime

http_code: Il codice restituito dal protocollo HTTP durante la scansione della pagina di provenienza.
type: integer

http_crawl: Il link è stato individuato senza eseguire JavaScript e senza rendering della pagina.
type: boolean

ip_source: L'indirizzo IP del dominio di provenienza.
type: string nullable

is_alternate: Il link con l'attributo rel="alternate".
type: boolean

is_canonical: Il link con l'attributo rel="canonical".
type: boolean

is_content: Il link è stato trovato nella porzione di contenuto più grande della pagina.
type: boolean

is_dofollow: Il link non ha alcun attributo nofollow speciale.
type: boolean

is_form: Il link è stato trovato in un tag HTML form.
type: boolean

is_frame: Il link è stato trovato in un tag HTML iframe.
type: boolean

is_homepage_link: Il link è stato trovato nella homepage di un sito web di provenienza.
type: boolean

is_image: Il link è un collegamento normale che include un'immagine nell'attributo href.
type: boolean

is_lost: Il link al momento non esiste più.
type: boolean

is_new: Il link è stato individuato nell'ultima scansione.
type: boolean

is_nofollow: Il link o la pagina di provenienza ha l'attributo nofollow impostato.
type: boolean

is_non_html: Il link punta a un URL con contenuto non HTML.
type: boolean

is_redirect: Il link punta al tuo target tramite un reindirizzamento.
type: boolean

is_redirect_lost: Il link reindirizzato al momento non esiste più.
type: boolean

is_root_source: Il nome di dominio di provenienza è un dominio root.
type: boolean

is_root_target: Il nome di dominio target è un dominio root.
type: boolean

is_rss: Il link è stato trovato in un feed RSS.
type: boolean

is_spam: Indica se il backlink proviene da un dominio noto come spam.
type: boolean

is_sponsored: Il link ha l'attributo Sponsored impostato nell'HTML della pagina di provenienza.
type: boolean

is_text: Il link è un collegamento ipertestuale href standard.
type: boolean

is_ugc: Il link ha l'attributo User Generated Content impostato nell'HTML della pagina di provenienza.
type: boolean

js_crawl: Il link è stato individuato dopo aver eseguito JavaScript e aver effettuato il rendering della pagina.
type: boolean

languages: Le lingue indicate nei metadati della pagina di provenienza o rilevate dal crawler come presenti nell'HTML.
type: array(string)

last_seen: La data in cui abbiamo rilevato che il link è stato perso.
type: datetime nullable

last_visited: La data in cui abbiamo verificato l'ultima volta la presenza di link attivi verso la tua pagina target.
type: datetime

len_url_redirect: Il numero di URL nella catena di reindirizzamento.
type: integer

link_group_count: Il numero di backlink raggruppati insieme in base al parametro di aggregazione. Questo campo non può essere usato con l'aggregazione 'all'.
type: integer

link_type: Il tipo di backlink.
type: string
enum: "redirect" "frame" "text" "form" "canonical" "alternate" "rss" "image"

linked_domains_source_domain: Il numero di domini root unici collegati dal dominio di provenienza.
type: integer

linked_domains_source_page: Il numero di domini root unici collegati dalla pagina di provenienza.
type: integer

linked_domains_target_domain: Il numero di domini root unici collegati dal dominio target.
type: integer

links_external: Il numero di link esterni dalla pagina di provenienza.
type: integer

links_internal: Il numero di link interni dalla pagina di provenienza.
type: integer

lost_reason: Il motivo per cui il link è stato perso durante l'ultima scansione.
type: string nullable
enum: "removedfromhtml" "notcanonical" "noindex" "pageredirected" "pageerror" "lostredirect" "notfound"

name_source: Il nome completo del dominio di provenienza, inclusi i sottodomini.
type: string

name_target: Il nome completo del dominio target, inclusi i sottodomini.
type: string

noindex: La pagina di provenienza ha l'attributo meta noindex.
type: boolean

page_category_source: Elenco separato da virgole di percorsi gerarchici di categoria previsti dall'IA per la pagina di provenienza. Ogni valore è un percorso con prefisso slash (es. /Business_and_Industrial/Advertising_and_Marketing/Marketing).
type: string nullable

page_size: La dimensione in byte del contenuto della pagina di provenienza.
type: integer

page_type_source: Elenco separato da virgole di percorsi gerarchici del tipo di pagina previsti dall'IA per la pagina di provenienza. Ogni valore è un percorso con prefisso slash (es. /Article/How_to).
type: string nullable

port_source: La porta di rete dell'URL della pagina di provenienza.
type: integer

port_target: La porta di rete dell'URL della pagina target.
type: integer

positions: Il numero di keyword per cui la pagina di provenienza si posiziona nelle prime 100 posizioni.
type: integer

positions_source_domain: Il numero di keyword per cui il dominio di provenienza si posiziona nelle prime 100 posizioni.
type: integer

powered_by: Le tecnologie web usate per creare e servire il contenuto della pagina di provenienza.
type: array(string)

redirect_code: Il codice di stato HTTP di una pagina di provenienza che punta al tuo target tramite un reindirizzamento.
type: integer nullable

redirect_kind: I codici di stato HTTP restituiti dall'URL target che reindirizza o dalla catena di reindirizzamento.
type: array(integer)

refdomains_source (5 units): Il numero di domini referral unici che si collegano alla pagina di provenienza.
type: integer

refdomains_source_domain (5 units): Il numero di domini referral unici che si collegano al dominio di provenienza.
type: integer

refdomains_target_domain (5 units): Il numero di domini referral unici che si collegano al dominio target.
type: integer

root_name_source: Il nome del dominio root del dominio di provenienza, senza sottodomini.
type: string

root_name_target: Il nome del dominio root del dominio target, senza sottodomini.
type: string

snippet_left: Lo snippet di testo che appare subito prima del link.
type: string

snippet_right: Lo snippet di testo che appare subito dopo il link.
type: string

source_page_author: L'autore della pagina di provenienza.
type: string nullable

source_page_publish_date: La data in cui abbiamo identificato che la pagina è stata pubblicata
type: date nullable

title: Il titolo HTML della pagina di provenienza.
type: string

tld_class_source: La classe di dominio di primo livello (TLD) del dominio di provenienza.
type: string
enum: "gov" "edu" "normal"

tld_class_target: La classe di dominio di primo livello (TLD) del dominio target.
type: string
enum: "gov" "edu" "normal"

traffic (10 units): Il traffico organico mensile stimato dalla ricerca per la pagina di provenienza.
type: integer

traffic_domain (10 units): Il traffico organico mensile stimato dalla ricerca per il dominio di provenienza.
type: integer

url_from: L'URL della pagina che contiene un link verso il tuo target.
type: string

url_from_plain: L'URL della pagina di provenienza ottimizzato per l'uso come filtro.
type: string

url_rating_source: La forza del profilo di backlink della pagina di provenienza rispetto alle altre nel nostro database su una scala di 100 punti.
type: float

url_redirect: Una catena di reindirizzamento a cui punta l'URL target del link.
type: array(url)

url_redirect_with_target: L'URL target del link con la relativa catena di reindirizzamento.
type: array(string)

url_to: L'URL a cui punta il backlink.
type: string

url_to_plain: L'URL della pagina target ottimizzato per l'uso come filtro.
type: string

selectstringObbligatorio

Un elenco di colonne separate da virgole da restituire. Consulta lo schema di risposta per gli identificatori di colonna validi.

protocolstring

Il protocollo del tuo target.

Valori consentiti:bothhttphttps

Predefinita:both

targetstringObbligatorio

Il target della ricerca: un dominio o un URL.

modestring

L'ambito della ricerca in base al target inserito.

Valori consentiti:exactprefixdomainsubdomains

Predefinita:subdomains

aggregationstring

La modalità di raggruppamento dei Backlinks.

Valori consentiti:similar_links1_per_domainall

Predefinita:similar_links

historystring

Un intervallo di tempo per aggiungere i backlinks persi al Report. Scegli tra live (nessuna cronologia), since:<date> (cronologia a partire da una data specificata) e all_time (cronologia completa). La data deve essere in formato YYYY-MM-DD.

Predefinita:all_time

outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

backlinksarray<object>

ahrefs_rank_sourceinteger

La forza del profilo di backlink del dominio referral rispetto agli altri siti web nel nostro database, con la posizione n. 1 come la più forte.

ahrefs_rank_targetinteger

La forza del profilo di backlink del dominio target rispetto agli altri siti web nel nostro database, con la posizione n. 1 come la più forte.

altstring or null

L'attributo alt del link.

anchorstring

Le parole cliccabili in un link che puntano a un URL.

broken_redirect_new_targetstring or null

La nuova destinazione di un redirect modificato.

broken_redirect_reasonstring or null

Il motivo per cui il redirect è stato considerato non funzionante durante l'ultima scansione.

Allowed values:droppedmanualdroppedtooolddroppedcodechangednxdomainrobotsdisallowedcurlerrorinvalidtargetnomorecanonicalisnowparkedtargetchanged

broken_redirect_sourcestring or null

L'URL di redirect che è stato modificato, facendo sì che il redirect diventasse non funzionante.

class_cinteger

(5 unità) Il numero di sottoreti class_c univoche che linkano alla pagina referral.

discovered_statusstring or null

Il motivo per cui il link è stato scoperto durante l'ultima scansione: la pagina è stata sottoposta a scansione per la prima volta, il link è stato aggiunto alla pagina oppure il link è ricomparso dopo essere stato rimosso.

Allowed values:pagefoundlinkfoundlinkrestored

domain_rating_sourcenumber

La forza del profilo di backlink del dominio referral rispetto agli altri nel nostro database su una scala a 100 punti.

domain_rating_targetnumber

La forza del profilo di backlink del dominio referral rispetto agli altri nel nostro database su una scala a 100 punti.

drop_reasonstring or null

Il motivo per cui abbiamo rimosso il link dal nostro indice.

Allowed values:manualnoratingunusednotoptoooldoldunavailablerescursiveduplicatenxdomainmalformedblockedportdisallowedunlinked

encodingstring

La codifica del set di caratteri dell'HTML della pagina referral.

first_seenstring

La data in cui l'URL della pagina referral è stato scoperto per la prima volta.

first_seen_linkstring

La data in cui abbiamo trovato per la prima volta un backlink al tuo target su una determinata pagina referral.

http_codeinteger

Il codice di risposta del protocollo HTTP restituito durante la scansione della pagina referral.

http_crawlboolean

Il link è stato scoperto senza eseguire JavaScript e senza renderizzare la pagina.

ip_sourcestring or null

L'indirizzo IP del dominio referral.

is_alternateboolean

Il collegamento con l'attributo rel="alternate".

is_canonicalboolean

Il collegamento con l'attributo rel="canonical".

is_contentboolean

Il link è stato trovato nella parte più grande del contenuto della pagina.

is_dofollowboolean

Il link non ha alcun attributo speciale Nofollow.

is_formboolean

Il link è stato trovato in un tag HTML form.

is_frameboolean

Il link è stato trovato in un tag HTML iframe.

is_imageboolean

Il link è un link normale che contiene un'immagine all'interno dell'attributo href.

is_lostboolean

Il link al momento non esiste più.

is_newboolean

Il link è stato scoperto durante l'ultima scansione.

is_nofollowboolean

Il link o la pagina referral ha l'attributo nofollow impostato.

is_redirectboolean

Collegamento che punta al tuo target tramite un reindirizzamento.

is_redirect_lostboolean

Il link reindirizzato attualmente non esiste più.

is_root_sourceboolean

Il nome del dominio di origine è un nome di dominio root.

is_root_targetboolean

Il nome del dominio target è un nome di dominio root.

is_rssboolean

Il link è stato trovato in un feed RSS.

is_spamboolean

Indica se il backlink proviene da un dominio noto per essere spam.

is_sponsoredboolean

Il link ha l'attributo Sponsored impostato nell'HTML della pagina di provenienza.

is_textboolean

Il link è un collegamento ipertestuale href standard.

is_ugcboolean

Il link ha l'attributo User Generated Content impostato nell'HTML della pagina di provenienza.

js_crawlboolean

Il link è stato individuato dopo l'esecuzione di JavaScript e il rendering della pagina.

languagesarray<string>

Le lingue indicate nei metadati della pagina di provenienza o rilevate dal crawler durante la scansione come presenti nell'HTML.

last_seenstring or null

La data in cui abbiamo scoperto che il link è andato perso.

last_visitedstring

La data in cui abbiamo verificato per l'ultima volta un link attivo alla tua pagina target.

link_group_countinteger

Il numero di Backlinks raggruppati in base al parametro di aggregazione. Questo campo non può essere utilizzato con l'aggregazione "all".

link_typestring

Il tipo di backlink.

Allowed values:redirectframetextformcanonicalalternaterssimage

linked_domains_source_domaininteger

Il numero di domini principali univoci che linkano dal dominio referral.

linked_domains_source_pageinteger

Il numero di domini principali univoci che linkano dalla pagina referral.

linked_domains_target_domaininteger

Il numero di domini principali univoci che linkano dal dominio di destinazione.

links_externalinteger

Il numero di link esterni della pagina referral.

links_internalinteger

Il numero di link interni della pagina referral.

lost_reasonstring or null

Il motivo per cui il link è stato perso durante l'ultima scansione.

Allowed values:removedfromhtmlnotcanonicalnoindexpageredirectedpageerrorlostredirectnotfound

name_sourcestring

Il nome completo del dominio referral, inclusi i sottodomini.

name_targetstring

Il nome completo del dominio di destinazione, inclusi i sottodomini.

noindexboolean

La pagina referral ha l'attributo meta noindex.

page_category_sourcestring or null

Elenco separato da virgole di percorsi di categoria gerarchici previsti dall'IA per la pagina referral. Ogni valore è un percorso con prefisso slash (ad es. /Business_and_Industrial/Advertising_and_Marketing/Marketing).

page_sizeinteger

La dimensione in byte del contenuto della pagina referral.

page_type_sourcestring or null

Elenco separato da virgole di percorsi gerarchici del tipo di pagina previsti dall'IA per la pagina referral. Ogni valore è un percorso con prefisso slash (ad es. /Article/How_to).

port_sourceinteger

La porta di rete dell'URL della pagina referral.

port_targetinteger

La porta di rete dell'URL della pagina target.

positionsinteger

Il numero di parole chiave per le quali la pagina referral si colloca nelle prime 100 posizioni.

powered_byarray<string>

Le tecnologie web utilizzate per creare e servire i contenuti della pagina referral.

redirect_codeinteger or null

Il codice di stato HTTP di una pagina referral che punta al tuo target tramite un reindirizzamento.

redirect_kindarray<integer>

I codici di stato HTTP restituiti dall'URL di reindirizzamento target o dalla catena di reindirizzamenti.

refdomains_sourceinteger

(5 unità) Il numero di domini referral univoci che linkano alla pagina referral.

refdomains_source_domaininteger

(5 unità) Il numero di domini referral univoci che linkano al dominio referral.

refdomains_target_domaininteger

(5 unità) Il numero di domini referral univoci che linkano al dominio target.

root_name_sourcestring

Il nome di dominio root del dominio referral, senza includere i sottodomini.

root_name_targetstring

Il nome di dominio root del dominio target, senza includere i sottodomini.

snippet_leftstring

Il frammento di testo che appare subito prima del link.

snippet_rightstring

Il frammento di testo che appare subito dopo il link.

source_page_authorstring or null

L'autore della pagina referral.

source_page_publish_datestring or null

la data in cui abbiamo identificato la data di pubblicazione della pagina

titlestring

Il titolo HTML della pagina referral.

tld_class_sourcestring

La classe del dominio di primo livello del dominio referral.

Allowed values:govedunormal

tld_class_targetstring

La classe del dominio di primo livello del dominio target.

Allowed values:govedunormal

trafficinteger

(10 unità) Il traffico organico mensile stimato della pagina referral proveniente dalla ricerca.

traffic_domaininteger

(10 unità) Una stima del Traffico organico mensile dai motori di ricerca del dominio referral.

url_fromstring

L'URL della pagina che contiene un collegamento al tuo target.

url_from_plainstring

L'URL della pagina referral ottimizzato per l'uso come filtro.

url_rating_sourcenumber

La forza del profilo di backlink della pagina referral rispetto alle altre nel nostro database, su una scala a 100 punti.

url_redirectarray<string>

Una catena di reindirizzamenti verso cui punta l'URL target del link.

url_redirect_with_targetarray<string>

L'URL target del link con la relativa catena di reindirizzamenti.

url_tostring

L'URL verso cui punta il backlink.

url_to_plainstring

L'URL della pagina target ottimizzato per l'uso come filtro.