Konkurenci organiczni

API + MCP

GET/v3/site-explorer/organic-competitors

Parametry zapytania

timeoutinteger

Ręcznie ustawiany limit czasu w sekundach.

limitinteger

Liczba wyników do zwrócenia.

Domyślne:1000

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

wherestring

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

competitor_domain: Domena konkurenta Twojego celu w trybie grupowania „domains".
typ: domain nullable

competitor_url: Adres URL konkurenta Twojego celu w trybie grupowania „pages".
typ: url nullable

cpc_competitor: Koszt za kliknięcie (CPC) — średnia cena, jaką reklamodawcy płacą za każde kliknięcie reklamy w płatnych wynikach wyszukiwania dla słowa kluczowego (w centach USD) — dla konkurenta.
typ: integer nullable

cpc_target: Koszt za kliknięcie (CPC) — średnia cena, jaką reklamodawcy płacą za każde kliknięcie reklamy w płatnych wynikach wyszukiwania dla słowa kluczowego (w centach USD) — dla celu.
typ: integer nullable

domain_rating: Siła profilu linków zwrotnych domeny na tle innych witryn w naszej bazie danych w skali 0–100.
typ: float

group_mode: Aby zamiast tego zobaczyć konkurencyjne strony, użyj trybu celu „exact URL" lub trybu celu „path", jeśli Twój cel nie ma wielu stron.
typ: string
enum: "domains" "pages"

keyword_difficulty_competitor (10 jednostek): Trudność słowa kluczowego — szacunek tego, jak trudno jest znaleźć się w Top 10 organicznych wyników wyszukiwania dla słowa kluczowego, w skali 0–100 — dla konkurenta.
typ: integer nullable

keyword_difficulty_target (10 jednostek): Trudność słowa kluczowego — szacunek tego, jak trudno jest znaleźć się w Top 10 organicznych wyników wyszukiwania dla słowa kluczowego, w skali 0–100 — dla celu.
typ: integer nullable

keywords_common: Organiczne słowa kluczowe, na które rankują zarówno Twój cel, jak i konkurent.
typ: integer

keywords_competitor: Organiczne słowa kluczowe, na które rankuje konkurent, a Twój cel nie.
typ: integer

keywords_target: Organiczne słowa kluczowe, na które rankuje Twój cel, a konkurent nie.
typ: integer

pages: Łączna liczba stron z celu rankujących w wynikach wyszukiwania.
typ: integer nullable

pages_diff: Zmiana liczby stron między wybranymi datami.
typ: integer

pages_merged: Pole stron zoptymalizowane pod sortowanie.
typ: integer

pages_prev: Łączna liczba stron z celu rankujących w wynikach wyszukiwania w dniu porównania.
typ: integer nullable

share: Procent wspólnych słów kluczowych w stosunku do łącznej liczby słów kluczowych, na które rankują zarówno Twój cel, jak i konkurent.
typ: float

traffic (10 jednostek): Szacunek liczby miesięcznych wizyt, jakie strona uzyskuje z wyszukiwania organicznego w ostatnim miesiącu lub w ostatnich znanych 12 miesiącach danych (w zależności od parametru "volume_mode").
typ: integer nullable

traffic_diff: Zmiana ruchu między wybranymi datami.
typ: integer

traffic_merged (10 jednostek): Pole ruchu zoptymalizowane pod sortowanie.
typ: integer

traffic_prev (10 jednostek): Szacunek liczby miesięcznych wizyt, jakie strona uzyskuje z wyszukiwania organicznego w ostatnim miesiącu lub w ostatnich znanych 12 miesiącach danych (w zależności od parametru "volume_mode") w dniu porównania.
typ: integer nullable

value (10 jednostek): Szacowana wartość miesięcznego ruchu z wyszukiwania organicznego strony (w centach USD).
typ: integer nullable

value_diff: Zmiana wartości między wybranymi datami.
typ: integer

value_merged (10 jednostek): Pole wartości zoptymalizowane pod sortowanie.
typ: integer nullable

value_prev (10 jednostek): Szacowana wartość miesięcznego ruchu z wyszukiwania organicznego strony (w centach USD) w dniu porównania.
typ: integer nullable

volume_competitor (10 jednostek): Szacunek średniej miesięcznej liczby wyszukiwań dla słowa kluczowego w ostatnim miesiącu lub w ostatnich znanych 12 miesiącach danych (w zależności od parametru "volume_mode") — dla konkurenta.
typ: integer nullable

volume_target (10 jednostek): Szacunek średniej miesięcznej liczby wyszukiwań dla słowa kluczowego w ostatnim miesiącu lub w ostatnich znanych 12 miesiącach danych (w zależności od parametru "volume_mode") — dla celu.
typ: integer nullable

words_competitor: Liczba słów w słowie kluczowym — dla konkurenta.
typ: integer

words_target: Liczba słów w słowie kluczowym — dla celu.
typ: integer

selectstringWymagane

Lista kolumn zwracanych w odpowiedzi, rozdzielona przecinkami. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

protocolstring

Protokół Twojego celu.

Dozwolone wartości:bothhttphttps

Domyślne:both

targetstringWymagane

Cel wyszukiwania: domena lub adres URL.

modestring

Zakres wyszukiwania na podstawie podanego celu.

Dozwolone wartości:exactprefixdomainsubdomains

Domyślne:subdomains

countrystringWymagane

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

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

date_comparedstring

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

datestringWymagane

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

volume_modestring

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

Dozwolone wartości:monthlyaverage

Domyślne:monthly

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

competitorsarray<object>

competitor_domainstring or null

Domena konkurenta Twojego celu w trybie grupowania „domains”.

competitor_urlstring or null

URL konkurenta Twojego celu w trybie grupowania „pages”.

domain_ratingnumber

Siła profilu linków zwrotnych domeny w porównaniu z innymi domenami w naszej bazie danych w 100-punktowej skali.

group_modestring

Aby zobaczyć konkurencyjne strony, użyj trybu celu „exact URL” lub trybu celu „path”, jeśli Twój cel nie ma wielu stron.

Allowed values:domainspages

keywords_commoninteger

Organiczne słowa kluczowe, dla których zarówno Twój cel, jak i konkurent zajmują pozycje.

keywords_competitorinteger

Organiczne słowa kluczowe, w przypadku których konkurent zajmuje pozycję w rankingu, ale Twój cel nie.

keywords_targetinteger

Organiczne słowa kluczowe, w przypadku których Twoja strona zajmuje pozycję, a konkurent nie.

pagesinteger or null

Całkowita liczba stron z wybranej witryny, które wyświetlają się w organicznych wynikach wyszukiwania.

pages_diffinteger

Zmiana liczby stron pomiędzy wybranymi datami.

pages_mergedinteger

Pole „strony” zoptymalizowane pod kątem sortowania.

pages_previnteger or null

Całkowita liczba stron z wybranej witryny, które wyświetlają się w wynikach wyszukiwania w dniu porównania.

sharenumber

Procent wspólnych słów kluczowych z całkowitej liczby słów kluczowych, w przypadku których zarówno Twój cel, jak i konkurent zajmują pozycję w rankingu.

trafficinteger or null

(10 units) Szacunkowa liczba miesięcznych wizyt na stronie pochodzących z organicznych wyników wyszukiwania za ostatni miesiąc lub za ostatnie znane 12 miesięcy danych — w zależności od parametru "volume_mode".

traffic_diffinteger

Zmiana ruchu pomiędzy wybranymi datami.

traffic_mergedinteger

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

traffic_previnteger or null

valueinteger or null

(10 units) Szacunkowa wartość miesięcznego ruchu organicznego na stronie, w centach USD.

value_diffinteger

Zmiana wartości pomiędzy wybranymi datami.

value_mergedinteger or null

(10 units) Pole „wartość” zoptymalizowane pod kątem sortowania.

value_previnteger or null

(10 units) Szacunkowa wartość miesięcznego ruchu organicznego na stronie, w centach USD, w dniu porównania.