Docs
Buscar documentación...⌘K

Páginas web

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

Devuelve páginas web que mencionan las marcas o competidores solicitados. Las menciones de marca se comparan con los títulos y el contenido de las páginas del índice web de Ahrefs.

Cuerpo de la solicitud

selectarray<string>Required

Una lista de campos que se deben devolver.

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

La expresión de filtro. Se reconocen los siguientes identificadores de columna (esto difiere de los identificadores reconocidos por el parámetro select).

report_idstring

El ID del informe que se usará. Si se proporciona uno, los demás parámetros se toman del informe (marca, competidores, mercado, país, filtros). Si se proporcionan el país o los filtros, prevalecen sobre los del informe. Puedes encontrarlo en la URL de tu informe de Brand Radar en Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

Una lista de nombres de marca y sitios web para encontrar menciones en páginas web.

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

Los nombres de la marca o del competidor

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

El dominio del objetivo

Example:ahrefs.com
scopestringrequired

Ámbito del objetivo.

Valores permitidos:urlpathdomainsubdomains
competitorsarray<object>

Una lista de nombres de competidores y sitios web para encontrar menciones en páginas web.

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

Los nombres de la marca o del competidor

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

El dominio del objetivo

Example:ahrefs.com
scopestringrequired

Ámbito del objetivo.

Valores permitidos:urlpathdomainsubdomains
content_filterobject

Frases opcionales usadas para incluir o excluir resultados según su contenido.

includearray<string>

Mostrar solo resultados que contengan al menos una de estas frases exactas.

excludearray<string>

Ocultar resultados que contengan cualquiera de estas frases exactas.

limitinteger

El número de páginas web que se devolverán.

Default:1000
order_bystring

Cómo ordenar las páginas web.

Valores permitidos:relevancetraffic
Default:relevance
page_typestring

Si se deben devolver todas las páginas web o solo páginas de noticias.

Valores permitidos:all_pagesnews
Default:all_pages
publication_typestring

Si se deben devolver todas las páginas, las páginas publicadas una sola vez o las páginas republicadas.

Valores permitidos:allpublished_oncerepublished
Default:all
date_fromstring (date)

El inicio del intervalo de fechas de publicación, en formato AAAA-MM-DD. Requiere date_to.

date_tostring (date)

El final inclusivo del intervalo de fechas de publicación, en formato AAAA-MM-DD. Requiere date_from.

platformstring

La plataforma o tecnología utilizada por la página.

Valores permitidos:allblogswordpressecommercecmsmessage-boardswikis
Default:all
languagestring

El idioma de la página.

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

El formato de salida.

Valores permitidos:jsoncsvxmlphp

Respuestas

pagesarray<object>
contentstring

Un extracto del contenido de la página que contiene la mención.

domain_ratinginteger

El Domain Rating del dominio de la página.

referring_domainsinteger or null

El número de dominios únicos que enlazan a la página.

titlestring

El título de la página.

trafficnumber (float) or null

El tráfico orgánico de búsqueda mensual estimado de la página.

traffic_valuenumber (float)

El valor mensual estimado del tráfico orgánico de búsqueda de la página, en USD.

urlstring (url)

La URL de la página que menciona una marca o un competidor solicitados.