Docs
Dokumentation durchsuchen...⌘K

Webseiten

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

Gibt Webseiten zurück, die die angeforderten Marken oder Wettbewerber erwähnen. Markenerwähnungen werden mit Seitentiteln und Inhalten aus dem Web-Index von Ahrefs abgeglichen.

Anfrage-Body

selectarray<string>Required

Eine Liste der Felder, die zurückgegeben werden sollen.

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

Der Filterausdruck. Die folgenden Spaltenbezeichner werden erkannt (diese unterscheiden sich von den Bezeichnern, die vom Parameter select erkannt werden).

report_idstring

Die ID des zu verwendenden Reports. Wenn eine angegeben wird, werden andere Parameter aus dem Report übernommen (brand, competitors, market, country, filters). Wenn country oder filters angegeben werden, überschreiben sie die Werte im Report. Sie finden sie in der URL Ihres Brand-Radar-Reports in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

Eine Liste von Markennamen und Websites, nach deren Erwähnungen auf Webseiten gesucht werden soll.

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

Die Namen der Marke/des Mitbewerbers

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

Die Domain des Ziels

Example:ahrefs.com
scopestringrequired

Geltungsbereich des Ziels.

Zulässige Werte:urlpathdomainsubdomains
competitorsarray<object>

Eine Liste von Wettbewerbernamen und Websites, nach deren Erwähnungen auf Webseiten gesucht werden soll.

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

Die Namen der Marke/des Mitbewerbers

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

Die Domain des Ziels

Example:ahrefs.com
scopestringrequired

Geltungsbereich des Ziels.

Zulässige Werte:urlpathdomainsubdomains
content_filterobject

Optionale Phrasen, mit denen Ergebnisse anhand ihres Inhalts ein- oder ausgeschlossen werden können.

includearray<string>

Zeigt nur Ergebnisse an, die mindestens eine dieser exakten Phrasen enthalten.

excludearray<string>

Blendet Ergebnisse aus, die eine dieser exakten Phrasen enthalten.

limitinteger

Die Anzahl der zurückzugebenden Webseiten.

Default:1000
order_bystring

Wie die Webseiten sortiert werden sollen.

Zulässige Werte:relevancetraffic
Default:relevance
page_typestring

Ob alle Webseiten oder nur Nachrichtenseiten zurückgegeben werden sollen.

Zulässige Werte:all_pagesnews
Default:all_pages
publication_typestring

Ob alle Seiten, einmal veröffentlichte Seiten oder erneut veröffentlichte Seiten zurückgegeben werden sollen.

Zulässige Werte:allpublished_oncerepublished
Default:all
date_fromstring (date)

Der Beginn des Veröffentlichungsdatumsbereichs im Format JJJJ-MM-TT. Erfordert date_to.

date_tostring (date)

Das Enddatum des Veröffentlichungsdatumsbereichs (einschließlich) im Format JJJJ-MM-TT. Erfordert date_from.

platformstring

Die Plattform oder Technologie, die von der Seite verwendet wird.

Zulässige Werte:allblogswordpressecommercecmsmessage-boardswikis
Default:all
languagestring

Die Sprache der Seite.

Zulässige Werte:allenesruzh-cnjaafsqarbnbgzh-twhrcsda…
Default:all
outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

pagesarray<object>
contentstring

Ein Auszug aus dem Seiteninhalt, der die Erwähnung enthält.

domain_ratinginteger

Das Domain-Rating der Domain der Seite.

referring_domainsinteger or null

Die Anzahl der einzigartigen Domains, die zu der Seite verlinken.

titlestring

Der Titel der Seite.

trafficnumber (float) or null

Der geschätzte monatliche organische Such-Traffic der Seite.

traffic_valuenumber (float)

Der geschätzte monatliche Wert des organischen Such-Traffics der Seite in USD.

urlstring (url)

Die URL der Seite, die eine angeforderte Marke oder einen angeforderten Wettbewerber erwähnt.