Strony płatne

API + MCP

GET/v3/site-explorer/paid-pages

Parametry zapytania

selectstringWymagane

Lista kolumn do zwrócenia, rozdzielona przecinkami. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

wherestring

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

order_bystring

Rozdzielana przecinkami lista kolumn, według których mają być sortowane wyniki, z opcjonalnym kierunkiem sortowania. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

Example:field_a,field_b:asc,field_c:desc

limitinteger

Liczba wyników do zwrócenia.

Domyślne:1000

timeoutinteger

Ręcznie ustawiany limit czasu w sekundach.

volume_modestring

Tryb obliczania wolumenu wyszukiwań: miesięczny lub średni. Wpływa na wolumen, ruch i wartość ruchu.

Dozwolone wartości:monthlyaverage

Domyślne:monthly

datestring (date)Wymagane

Data, dla której mają zostać raportowane metryki, w formacie YYYY-MM-DD.

date_comparedstring (date)

Data do porównania metryk w formacie YYYY-MM-DD.

countrystring

Dwuliterowy kod kraju (ISO 3166-1 alpha-2).

Dozwolone wartości:adaeafagaialamaoarasatauawazba…

modestring

Zakres wyszukiwania na podstawie wprowadzonego celu.

Dozwolone wartości:exactprefixdomainsubdomains

Domyślne:subdomains

targetstring (url)Wymagane

Cel wyszukiwania: domena lub adres URL.

portfolio_idinteger

Unikalny identyfikator portfolio. Jeśli zostanie podany, ma pierwszeństwo przed target.

protocolstring

Protokół celu.

Dozwolone wartości:bothhttphttps

Domyślne:both

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

pagesarray<object>

ads_countinteger or null

Liczba unikatowych reklam ze stroną.

ads_count_diffinteger

Zmiana liczby reklam pomiędzy wybranymi datami.

ads_count_previnteger or null

Liczba reklam w dniu porównania.

keywordsinteger or null

Łączna liczba słów kluczowych, na które pozycjonowana jest wybrana witryna w płatnych wynikach wyszukiwania.

keywords_diffinteger

Zmiana dotycząca słów kluczowych pomiędzy wybranymi datami.

keywords_diff_percentinteger

Zmiana dotycząca słów kluczowych pomiędzy wybranymi datami, w procentach.

keywords_mergedinteger

Całkowita liczba słów kluczowych zoptymalizowanych pod kątem sortowania.

keywords_previnteger or null

Słowo kluczowe, na które pozycjonuje się Twój cel na datę porównawczą.

raw_urlstring

Adres URL strony w rankingu w zakodowanym formacie.

raw_url_prevstring or null

Adres URL strony w rankingu na datę porównawczą w zakodowanym formacie.

referring_domainsinteger or null

(5 jednostek) Liczba unikalnych domen odsyłających do strony.

statusstring

Status strony: nowa strona, która właśnie zaczęła rankować w płatnych wynikach („left”), utracona strona, która zniknęła z płatnych wyników („right”), lub brak zmian („both”).

Dozwolone wartości:leftrightboth

sum_trafficinteger or null

(10 jednostek) Szacunek miesięcznego płatnego ruchu z wyszukiwania, jaki strona uzyskuje ze wszystkich słów kluczowych, na które się pozycjonuje.

sum_traffic_mergedinteger

(10 jednostek) Pole ruchu płatnego zoptymalizowane pod kątem sortowania.

sum_traffic_previnteger or null

(10 jednostek) Ruch płatny w dacie porównawczej.

top_keywordstring or null

Słowo kluczowe, które generuje najwięcej płatnego ruchu na stronie.

top_keyword_best_positioninteger or null

Pozycja strony w rankingu dla jej najpopularniejszego słowa kluczowego.

top_keyword_best_position_diffinteger or null

Zmiana najlepszej pozycji między wybranymi datami.

top_keyword_best_position_kindstring or null

Rodzaj najlepszej pozycji: organiczna, płatna lub funkcja SERP.

Dozwolone wartości:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

top_keyword_best_position_kind_prevstring or null

Rodzaj najwyższej pozycji w dniu porównania.

Dozwolone wartości:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

top_keyword_best_position_previnteger or null

Najwyższa pozycja w dniu porównania.

top_keyword_best_position_titlestring or null

Tytuł wyświetlany dla strony w SERP dla jej najlepszego słowa kluczowego.

top_keyword_best_position_title_prevstring or null

Tytuł wyświetlany dla strony w SERP dla jej najlepszego słowa kluczowego na datę porównawczą.

top_keyword_countrystring or null

Kraj, w którym strona jest notowana dla jej najlepszego słowa kluczowego.

Dozwolone wartości:ADAEAFAGAIALAMAOAQARASATAUAWAX…

top_keyword_country_prevstring or null

Kraj, w którym strona jest notowana dla jej najlepszego słowa kluczowego na datę porównawczą.

Dozwolone wartości:ADAEAFAGAIALAMAOAQARASATAUAWAX…

top_keyword_prevstring or null

Słowo kluczowe, które w dniu porównania przynosi stronie najwięcej płatnego ruchu.

top_keyword_volumeinteger or null

(10 jednostek) Szacunkowa średnia miesięczna liczba wyszukiwań dla najlepszego słowa kluczowego z ostatniego miesiąca lub z ostatnich znanych 12 miesięcy danych (w zależności od parametru „volume_mode").

top_keyword_volume_previnteger or null

(10 jednostek) Wolumen wyszukiwań na datę porównania.

traffic_diffinteger

Zmiana ruchu pomiędzy wybranymi datami.

traffic_diff_percentinteger

Zmiana ruchu pomiędzy wybranymi datami, w procentach.

urnumber (float) or null

Ocena URL (UR) pokazuje siłę profilu linków zwrotnych Twojej strony docelowej w 100-punktowej skali logarytmicznej.

urlstring (url) or null

Adres URL strony rankującej.

url_prevstring (url) or null

Adres URL strony rankującej w dniu porównania.

valueinteger or null

(10 jednostek) Szacowany koszt miesięcznego płatnego ruchu z wyszukiwania strony, w centach USD.

value_diffinteger

Różnica w wartości ruchu pomiędzy wybranymi datami.

value_diff_percentinteger

Różnica w metryce „Wartość ruchu” pomiędzy wybranymi datami, w procentach.

value_mergedinteger or null

(10 jednostek) Pole „Wartość ruchu” zoptymalizowane pod kątem sortowania.

value_previnteger or null

(10 jednostek) „Wartość ruchu” w dniu porównania.