Docs
Cerca nella documentazione...⌘K

Pagine web

API + MCPSolo Enterprise
POST/v3/brand-radar/web-pages

Restituisce le pagine web che menzionano i brand o i competitor richiesti. Le menzioni dei brand vengono confrontate con i titoli e i contenuti delle pagine presenti nell’indice web di Ahrefs.

Corpo della richiesta

selectarray<string>Required

Un elenco di campi da restituire.

Example:["field_a","field_b"]
whereobject

L’espressione di filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi dagli identificatori riconosciuti dal parametro select).

report_idstring

L’ID del report da usare. Se ne viene fornito uno, gli altri parametri vengono presi dal report (brand, concorrenti, mercato, paese, filtri). Se vengono forniti paese o filtri, questi sovrascrivono quelli del report. Puoi trovarlo nell’URL del report Brand Radar in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

Un elenco di nomi di brand e siti web di cui trovare menzioni nelle pagine web.

Default:[]
At least one of names or url_groups is required
namesarray<string>

I nomi del brand/concorrente

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Il dominio del target

Example:ahrefs.com
scopestringrequired

Ambito del target.

Valori consentiti:urlpathdomainsubdomains
competitorsarray<object>

Un elenco di nomi e siti web dei competitor di cui trovare menzioni nelle pagine web.

Default:[]
At least one of names or url_groups is required
namesarray<string>

I nomi del brand/concorrente

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Il dominio del target

Example:ahrefs.com
scopestringrequired

Ambito del target.

Valori consentiti:urlpathdomainsubdomains
content_filterobject

Frasi facoltative usate per includere o escludere i risultati in base al loro contenuto.

includearray<string>

Mostra solo i risultati che contengono almeno una di queste frasi esatte.

excludearray<string>

Nascondi i risultati che contengono una qualsiasi di queste frasi esatte.

limitinteger

Il numero di pagine web da restituire.

Default:1000
order_bystring

Come ordinare le pagine web.

Valori consentiti:relevancetraffic
Default:relevance
page_typestring

Se restituire tutte le pagine web o solo le pagine di notizie.

Valori consentiti:all_pagesnews
Default:all_pages
publication_typestring

Se restituire tutte le pagine, le pagine pubblicate una sola volta o le pagine ripubblicate.

Valori consentiti:allpublished_oncerepublished
Default:all
date_fromstring (date)

L’inizio dell’intervallo di date di pubblicazione, nel formato YYYY-MM-DD. Richiede date_to.

date_tostring (date)

La fine inclusa dell’intervallo di date di pubblicazione, nel formato YYYY-MM-DD. Richiede date_from.

platformstring

La piattaforma o la tecnologia utilizzata dalla pagina.

Valori consentiti:allblogswordpressecommercecmsmessage-boardswikis
Default:all
languagestring

La lingua della pagina.

Valori consentiti:allenesruzh-cnjaafsqarbnbgzh-twhrcsda…
Default:all
outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

pagesarray<object>
contentstring

Un estratto del contenuto della pagina che contiene la menzione.

domain_ratinginteger

Il Domain Rating del dominio della pagina.

referring_domainsinteger or null

Il numero di domini univoci che contengono un link alla pagina.

titlestring

Il titolo della pagina.

trafficnumber (float) or null

Il traffico di ricerca organico mensile stimato della pagina.

traffic_valuenumber (float)

Il valore mensile stimato del traffico di ricerca organico della pagina, in USD.

urlstring (url)

L’URL della pagina che menziona un brand o un competitor richiesto.