Docs
Pesquisar na documentação...⌘K

Páginas da web

API + MCPApenas para Enterprise
POST/v3/brand-radar/web-pages

Retorna páginas da web que mencionam as marcas ou os concorrentes solicitados. As menções de marca são verificadas com base nos títulos das páginas e no conteúdo do índice da web da Ahrefs.

Corpo da solicitação

selectarray<string>Required

Uma lista de campos a serem retornados.

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

A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (isso é diferente dos identificadores reconhecidos pelo parâmetro select).

report_idstring

O ID do relatório a ser usado. Se um ID for informado, os outros parâmetros serão obtidos do relatório (brand, competitors, market, country, filters). Se os parâmetros country ou filters forem fornecidos, eles substituirão os do relatório. Você pode encontrá-lo na URL do seu relatório do Brand Radar no Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

Uma lista de nomes de marcas e sites para encontrar menções em páginas da web.

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

Os nomes da marca/concorrente

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

O domínio do alvo

Example:ahrefs.com
scopestringrequired

Escopo do alvo.

Valores permitidos:urlpathdomainsubdomains
competitorsarray<object>

Uma lista de nomes de concorrentes e sites para encontrar menções em páginas da web.

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

Os nomes da marca/concorrente

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

O domínio do alvo

Example:ahrefs.com
scopestringrequired

Escopo do alvo.

Valores permitidos:urlpathdomainsubdomains
content_filterobject

Frases opcionais usadas para incluir ou excluir resultados com base no conteúdo.

includearray<string>

Mostrar apenas resultados que contenham pelo menos uma destas frases exatas.

excludearray<string>

Ocultar resultados que contenham qualquer uma destas frases exatas.

limitinteger

O número de páginas da web a retornar.

Default:1000
order_bystring

Como ordenar as páginas da web.

Valores permitidos:relevancetraffic
Default:relevance
page_typestring

Se deve retornar todas as páginas da web ou apenas páginas de notícias.

Valores permitidos:all_pagesnews
Default:all_pages
publication_typestring

Se deve retornar todas as páginas, páginas publicadas uma vez ou páginas republicadas.

Valores permitidos:allpublished_oncerepublished
Default:all
date_fromstring (date)

O início do intervalo de datas de publicação, no formato AAAA-MM-DD. Requer date_to.

date_tostring (date)

O fim inclusivo do intervalo de datas de publicação, no formato AAAA-MM-DD. Requer date_from.

platformstring

A plataforma ou tecnologia usada pela página.

Valores permitidos:allblogswordpressecommercecmsmessage-boardswikis
Default:all
languagestring

O idioma da página.

Valores permitidos:allenesruzh-cnjaafsqarbnbgzh-twhrcsda…
Default:all
outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

pagesarray<object>
contentstring

Um trecho do conteúdo da página que contém a menção.

domain_ratinginteger

A classificação de domínio do domínio da página.

referring_domainsinteger or null

O número de domínios exclusivos vinculados à página.

titlestring

O título da página.

trafficnumber (float) or null

O tráfego mensal estimado de busca orgânica da página.

traffic_valuenumber (float)

O valor mensal estimado do tráfego de busca orgânica da página, em USD.

urlstring (url)

A URL da página que menciona uma marca solicitada ou um concorrente solicitado.