Docs
ドキュメントを検索...⌘K

ウェブページ

API + MCPエンタープライズ限定
POST/v3/brand-radar/web-pages

指定されたブランドまたは競合に言及しているウェブページを返します。ブランドへの言及は、Ahrefs のウェブインデックスに含まれるページタイトルとコンテンツに照合されます。

リクエスト本文

selectarray<string>Required

返すフィールドのリスト。

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

フィルター式。次の列識別子が認識されます（これは select パラメータで認識される識別子とは異なります）。

report_idstring

使用するレポートのIDです。指定した場合、他のパラメータ（ブランド、競合、マーケット、国、フィルター）はレポートから取得されます。country または filters を指定すると、レポート内の設定よりも優先されます。Ahrefs のブランドレーダーのレポート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>

これらの完全一致フレーズのうち、少なくとも1つを含む結果のみを表示します。

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。