Docs
Szukaj w dokumentacji...⌘K

Witryny internetowe

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

Zwraca strony internetowe, które zawierają wzmianki o wskazanych markach lub konkurentach. Wzmianki o markach są dopasowywane na podstawie tytułów stron i treści z indeksu internetowego Ahrefs.

Treść żądania

selectarray<string>Required

Lista pól do zwrócenia.

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

Wyrażenie filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się one od identyfikatorów rozpoznawanych przez parametr select).

report_idstring

ID raportu, którego należy użyć. Jeśli zostanie podane, pozostałe parametry są pobierane z raportu (marka, konkurenci, rynek, kraj, filtry). Jeśli podano kraj lub filtry, zastępują one wartości z raportu. Znajdziesz je w adresie URL raportu Brand Radar w Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

Lista nazw marek i witryn internetowych, o których wzmianki mają być wyszukiwane na stronach internetowych.

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

Nazwy marki/konkurenta

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

Domena celu

Example:ahrefs.com
scopestringrequired

Zakres celu.

Dozwolone wartości:urlpathdomainsubdomains
competitorsarray<object>

Lista nazw konkurentów i witryn internetowych, o których wzmianki mają być wyszukiwane na stronach internetowych.

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

Nazwy marki/konkurenta

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

Domena celu

Example:ahrefs.com
scopestringrequired

Zakres celu.

Dozwolone wartości:urlpathdomainsubdomains
content_filterobject

Opcjonalne frazy służące do uwzględniania lub wykluczania wyników na podstawie ich treści.

includearray<string>

Wyświetlaj tylko wyniki zawierające co najmniej jedną z tych dokładnych fraz.

excludearray<string>

Ukrywaj wyniki zawierające dowolną z tych dokładnych fraz.

limitinteger

Liczba stron internetowych do zwrócenia.

Default:1000
order_bystring

Sposób sortowania stron internetowych.

Dozwolone wartości:relevancetraffic
Default:relevance
page_typestring

Czy zwrócić wszystkie strony internetowe, czy tylko strony z wiadomościami.

Dozwolone wartości:all_pagesnews
Default:all_pages
publication_typestring

Czy zwrócić wszystkie strony, strony opublikowane raz czy strony opublikowane ponownie.

Dozwolone wartości:allpublished_oncerepublished
Default:all
date_fromstring (date)

Początek zakresu dat publikacji w formacie YYYY-MM-DD. Wymaga date_to.

date_tostring (date)

Koniec zakresu dat publikacji (włącznie), w formacie YYYY-MM-DD. Wymaga date_from.

platformstring

Platforma lub technologia używana przez stronę.

Dozwolone wartości:allblogswordpressecommercecmsmessage-boardswikis
Default:all
languagestring

Język strony.

Dozwolone wartości:allenesruzh-cnjaafsqarbnbgzh-twhrcsda…
Default:all
outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

pagesarray<object>
contentstring

Fragment treści strony zawierający wzmiankę.

domain_ratinginteger

Ocena domeny dla domeny, do której należy strona.

referring_domainsinteger or null

Całkowita liczba unikalnych domen odsyłających do strony.

titlestring

Tytuł strony.

trafficnumber (float) or null

Szacowany miesięczny ruch z organicznych wyników wyszukiwania dla strony.

traffic_valuenumber (float)

Szacowana miesięczna wartość ruchu z organicznych wyników wyszukiwania dla strony, w USD.

urlstring (url)

URL strony zawierającej wzmiankę o wskazanej marce lub konkurencie.