Некоторые функции ограничены.
Вход Регистрация

Мы используем файлы cookie для обеспечения работоспособности сервиса, улучшения навигации и маркетинговых активностей Serpstat. Нажимая "Принять и продолжить", вы соглашаетесь с нашей Политика конфиденциальности

Получение списка доменов из топ-20 по ключевым фразам проекта (getTopCompetitorsDomainsHistory)

Метод getTopCompetitorsDomainsHistory возвращает список доменов по региону проекта, которые попали в топ-20 минимум по 2 любым ключевым фразам проекта. Аналогичен отчету Мониторинг позиций — Конкуренты.

Общие параметры запроса и инструкция по использованию Serpstat API

Параметры запроса
Параметр Значение Описание
id обязательно  any number or string Идентификатор запроса
method обязательно RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory Название метода API
params обязательно {...} Объект с параметрами
projectId обязательно number
Идентификатор проекта
projectRegionId обязательно number
Идентификатор региона
page обязательно number
Номер страницы. По умолчанию 1
pageSize опционально number (20, 50, 100, 200, 500) Количество результатов на странице. По умолчанию 100
dateFrom опционально date (yyyy-mm-dd)
Дата начала периода, по которому нужны данные. По умолчанию — 30 дней от последнего снятия позиции.
dateTo опционально date (yyyy-mm-dd)
Дата конца периода, по которому нужны данные. По умолчанию дата последнего снятия позиции.
sort опционально string:
* sum_traffic распределение трафика;
* keywords_count количество ключевых фраз;
* avg_position средняя позиция;
* position_ranges топы распределения позиций;
* ads_count количество платных объявлений
Параметр, по которому будет производиться сортировка. По умолчанию — по распределению трафика. 
sortRange опционально string:
* top1\top2... распределение по позициям;
* keywords_count_bottom\keywords_count_top\ распределение по рекламным блокам;
* avg_position_top\avg_position_bottom\ средняя позиция по рекламным блока

Используется при сортировке по *position_ranges*.


order опционально string:
* asc — по возрастанию;
* desc — по убыванию
Направление сортировки. По умолчанию  по убыванию.
domains опционально array: ["domain1.com", "domain2.com"] Домены, по которым нужны данные. По умолчанию информация приходит по всем доменам, что попали в топ-20, минимум по 2 ключевым фразам проекта.

Параметры ответа
Параметр Описание
id Идентификатор запроса: соответствует id в запросе
result Содержит в себе ответ
data
Объект с данными
projectId Идентификатор проекта
projectRegionId Идентификатор региона
competitors Массив с доменами
domain Домен, который встретился в выдаче топ-20, минимум по 2 ключевым фразам проекта
dates Массив дат с данными по указанному домену
date Дата, за которую выводятся данные по домену
value Значение параметра
traffic_distribution Распределение трафика домена среди всех доменов в топ-20
avg_position Средняя позиция домена среди лучших позиций по ключевым фразам проекта
keywords_count Количество ключевых фраз, по которым домен попал в выдачу
keywords_by_ranges Распределение ключевых фраз по диапазонам позиций домена
top1 Ключевые фразы, где домен занял 1 позицию
top3 Ключевые фразы, где домен занял 2-3 позицию
top5 Ключевые фразы, где домен занял 4-5 позицию
top10 Ключевые фразы, где домен занял 6-10 позицию
top20 Ключевые фразы, где домен занял 11-20 позицию
top101 Ключевые фразы, где домен занял 21-100 позицию в Google, и 21-50 позицию в Yandex
Регионы с контекстом 
ads_count Количество объявлений домена, которые встретились в контексте
keywords_count_blocks Распределение ключевых фраз по блокам контекста
avg_position_blocks Распределение средних позиций по блокам контекста
top Верхний блок рекламы
sidebar Боковой блок рекламы
bottom Нижний блок рекламы
summary info Блок сводной информации
page Текущая страница
page_total Количество страниц с результатами при выбранном параметре pageSize
count Количество результатов на страницу
total Общее количество результатов
sort   Сортировка по параметрам
order     Направление сортировки

По этому методу лимиты не списываются.

Example
Request data:
{
    "id": "1",
    "method": "RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory",
   "params": {
        "projectId": 853932,
        "projectRegionId": 293402,
        "page": 1,
        "pageSize": 20,
        "dateFrom": "2021-07-26",
        "dateTo": "2021-07-27",
        "sort": "domain",
        "order": "asc",
        "domains": [
            "adidas.com",
            "nike.com"
        ]  
    }
}
Response data:

{
    "id": "1",
    "result": {
        "data": {
            "projectId": 853932,
            "projectRegionId": 293402,
            "competitors": [
                {
                    "domain": "adidas.com",
                    "dates": [
                        {
                            "date": "2021-07-26",
                            "result": {
                                "traffic_distribution": {
                                    "value": 19.390000000000001
                                },
                                "avg_position": {
                                    "value": 2.7000000000000002
                                },
                                "keywords_count": {
                                    "value": 12
                                },
                                "keywords_by_ranges": {
                                    "top1": {
                                        "value": 5
                                    },
                                    "top3": {
                                        "value": 3
                                    },
                                    "top5": {
                                        "value": 3
                                    },
                                    "top10": {
                                        "value": 1
                                    },
                                    "top20": {
                                        "value": 0
                                    },
                                    "top101": {
                                        "value": 0
                                    }
                                }
                            }
                        },
                        {
                            "date": "2021-07-27",
                            "result": {
                                "traffic_distribution": {
                                    "value": 17.25
                                },
                                "avg_position": {
                                    "value": 3.1000000000000001
                                },
                                "keywords_count": {
                                    "value": 12
                                },
                                "keywords_by_ranges": {
                                    "top1": {
                                        "value": 6
                                    },
                                    "top3": {
                                        "value": 2
                                    },
                                    "top5": {
                                        "value": 2
                                    },
                                    "top10": {
                                        "value": 2
                                    },
                                    "top20": {
                                        "value": 0
                                    },
                                    "top101": {
                                        "value": 0
                                    }
                                }
                            }
                        }
                    ]
                },
                {
                    "domain": "nike.com",
                    "dates": [
                        {
                            "date": "2021-07-26",
                            "result": {
                                "traffic_distribution": {
                                    "value": 7.6299999999999999
                                },
                                "avg_position": {
                                    "value": 15.1
                                },
                                "keywords_count": {
                                    "value": 9
                                },
                                "keywords_by_ranges": {
                                    "top1": {
                                        "value": 0
                                    },
                                    "top3": {
                                        "value": 2
                                    },
                                    "top5": {
                                        "value": 1
                                    },
                                    "top10": {
                                        "value": 3
                                    },
                                    "top20": {
                                        "value": 2
                                    },
                                    "top101": {
                                        "value": 1
                                    }
                                }
                            }
                        },
                        {
                            "date": "2021-07-27",
                            "result": {
                                "traffic_distribution": {
                                    "value": 7.6799999999999997
                                },
                                "avg_position": {
                                    "value": 14.6
                                },
                                "keywords_count": {
                                    "value": 9
                                },
                                "keywords_by_ranges": {
                                    "top1": {
                                        "value": 0
                                    },
                                    "top3": {
                                        "value": 2
                                    },
                                    "top5": {
                                        "value": 1
                                    },
                                    "top10": {
                                        "value": 3
                                    },
                                    "top20": {
                                        "value": 2
                                    },
                                    "top101": {
                                        "value": 1
                                    }
                                }
                            }
                        }
                    ]
                }
            ]
        },
        "summary_info": {
            "page": 1,
            "page_total": 1,
            "count": 20,
            "total": 2,
            "sort": "domain",
            "order": "asc"
        },
        "spent_limits": 0
    }
}