Docs
搜索文档...⌘K

网页

API + MCP仅限企业版
POST/v3/brand-radar/web-pages

返回提及所请求的品牌或竞品的网页。品牌提及会与 Ahrefs 网页索引中的页面标题和内容进行匹配。

请求正文

selectarray<string>Required

要返回的字段列表。

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

过滤表达式。系统支持以下列标识符（这与 select 参数支持的标识符不同）。

report_idstring

要使用的报告 ID。如果提供该参数，则其他参数将从报告中获取（品牌、竞争对手、市场、国家/地区、筛选条件）。如果提供了国家/地区或筛选条件，它们将覆盖报告中的对应值。你可以在 Ahrefs 的 Brand Radar 报告 URL 中找到它：https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

要在网页上查找其提及情况的品牌名称和网站列表。

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

品牌/竞争对手的名称

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

目标对象的域名

Example:ahrefs.com
scopestringrequired

目标对象的范围。

允许的值:urlpathdomainsubdomains
competitorsarray<object>

要在网页上查找其提及情况的竞争对手名称和网站列表。

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

品牌/竞争对手的名称

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

目标对象的域名

Example:ahrefs.com
scopestringrequired

目标对象的范围。

允许的值:urlpathdomainsubdomains
content_filterobject

可选短语，用于根据内容包含或排除结果。

includearray<string>

仅显示至少包含以下任一完全匹配短语的结果。

excludearray<string>

隐藏包含以下任一完全匹配短语的结果。

limitinteger

要返回的网页数量。

Default:1000
order_bystring

网页的排序方式。

允许的值:relevancetraffic
Default:relevance
page_typestring

是返回所有网页还是仅返回新闻页面。

允许的值:all_pagesnews
Default:all_pages
publication_typestring

是返回所有页面、只发布过一次的页面，还是重新发布的页面。

允许的值:allpublished_oncerepublished
Default:all
date_fromstring (date)

发布日期范围的起始日期，格式为 YYYY-MM-DD。需要提供 date_to。

date_tostring (date)

发布日期范围的结束日期（含该日期），格式为 YYYY-MM-DD。需要提供 date_from。

platformstring

页面使用的平台或技术。

允许的值:allblogswordpressecommercecmsmessage-boardswikis
Default:all
languagestring

页面的语言。

允许的值:allenesruzh-cnjaafsqarbnbgzh-twhrcsda…
Default:all
outputstring

输出格式。

允许的值:jsoncsvxmlphp

响应

pagesarray<object>
contentstring

包含提及内容的页面内容摘录。

domain_ratinginteger

该页面所在域名的域名评分。

referring_domainsinteger or null

链接到页面的唯一域名数。

titlestring

页面标题。

trafficnumber (float) or null

该页面预估的月度自然搜索流量。

traffic_valuenumber (float)

该页面自然搜索流量的月度预估价值，以 USD 计。

urlstring (url)

提及所请求品牌或竞争对手的页面 URL。