Некоторые функции ограничены.

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

Нажав кнопку "Принять и продолжить", вы соглашаетесь с Политикой конфиденциальности

Вход Регистрация

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

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

Параметры запроса
Параметр Значение Описание
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  (desc | asc) Направление сортировки. По умолчанию - по убыванию.
domains (необязательно) array:[“string”] Домен, по которому нужны данные. По умолчанию информация приходит по всем доменам, что попали в топ-20, минимум по 2 ключевым фразам проекта.

Параметры ответа
Параметр Описание
id Идентификатор запроса
result Инкапсулирует в себе ответ
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 Количество страниц с результатами при выбранном параметре page size
count Количество результатов на страницу
total Общее количество результатов
sort   Сортировка по параметрам
order     Направление сортировки

Example PHP Python
Request data:
{
    "id": "1",
    "method": "RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory",
   "params": {
        "projectId": 651696,
        "projectRegionId": 249084,
        "page": 1,
        "pageSize": 20,
        "dateFrom": "2020-08-27",
        "dateTo": "2020-08-28",
        "sort": "domain",
        "order": "asc",
        "domains": [
            "fursk.ru",
            "ozon.ru"
        ]
    }
}

Response data:

{
    "id": "1",
    "result": {
        "data": {
            "projectId": 651696,
            "projectRegionId": 249084,
            "competitors": [
                {
                    "domain": "fursk.ru",
                    "dates": {
                        "1": {
                            "date": "2020-08-28",
                            "result": {
                                "traffic_distribution": {
                                    "value": 2.52
                                },
                                "avg_position": {
                                    "value": 31.5
                                },
                                "keywords_count": {
                                    "value": 6015
                                },
                                "keywords_by_ranges": {
                                    "top1": {
                                        "value": 50
                                    },
                                    "top3": {
                                        "value": 206
                                    },
                                    "top5": {
                                        "value": 258
                                    },
                                    "top10": {
                                        "value": 752
                                    },
                                    "top20": {
                                        "value": 1400
                                    },
                                    "top101": {
                                        "value": 3349
                                    }
                                }
                            }
                        }
                    }
                },
                {
                    "domain": "ozon.ru",
                    "dates": {
                        "1": {
                            "date": "2020-08-28",
                            "result": {
                                "traffic_distribution": {
                                    "value": 2.0299999999999998
                                },
                                "avg_position": {
                                    "value": 31.600000000000001
                                },
                                "keywords_count": {
                                    "value": 4333
                                },
                                "keywords_by_ranges": {
                                    "top1": {
                                        "value": 66
                                    },
                                    "top3": {
                                        "value": 151
                                    },
                                    "top5": {
                                        "value": 146
                                    },
                                    "top10": {
                                        "value": 414
                                    },
                                    "top20": {
                                        "value": 1168
                                    },
                                    "top101": {
                                        "value": 2388
                                    }
                                }
                            }
                        }
                    }
                }
            ]
        },
        "summary_info": {
            "page": 1,
            "page_total": 1,
            "count": 20,
            "total": 2,
            "sort": "domain",
            "order": "asc"
        },
        "spent_limits": 0
    }
}

Request data for PPC

{
    "id": "1",
    "method": "RtApiSerpResultsProcedure.getTopCompetitorsDomainsHistory",
   "params": {
        "projectId": 650028,
        "projectRegionId": 249037,
        "page": 1,
        "pageSize": 20,
        "dateFrom": "2020-10-22",
        "dateTo": "2020-10-23",
        "sort": "domain",
        "order": "asc",
        "domains":["citrus.ua","comfy.ua","allo.ua"]
    }
}

Response data

{
    "id": "1",
    "result": {
        "data": {
            "projectId": 650028,
            "projectRegionId": 249037,
            "competitors": [
                {
                    "domain": "allo.ua",
                    "dates": {
                        "1": {
                            "date": "2020-10-22",
                            "result": {
                                "keywords_count": {
                                    "value": 3
                                },
                                "ads_count": {
                                    "value": 3
                                },
                                "keywords_count_blocks": {
                                    "top": {
                                        "value": 1
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 2
                                    }
                                },
                                "avg_position_blocks": {
                                    "top": {
                                        "value": 1
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 1.5
                                    }
                                }
                            }
                        },
                        "2": {
                            "date": "2020-10-23",
                            "result": {
                                "keywords_count": {
                                    "value": 6
                                },
                                "ads_count": {
                                    "value": 6
                                },
                                "keywords_count_blocks": {
                                    "top": {
                                        "value": 2
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 4
                                    }
                                },
                                "avg_position_blocks": {
                                    "top": {
                                        "value": 1.5
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 1.3
                                    }
                                }
                            }
                        }
                    }
                },
                {
                    "domain": "citrus.ua",
                    "dates": {
                        "1": {
                            "date": "2020-10-22",
                            "result": {
                                "keywords_count": {
                                    "value": 49
                                },
                                "ads_count": {
                                    "value": 49
                                },
                                "keywords_count_blocks": {
                                    "top": {
                                        "value": 35
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 14
                                    }
                                },
                                "avg_position_blocks": {
                                    "top": {
                                        "value": 1.1000000000000001
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 1.2
                                    }
                                }
                            }
                        },
                        "2": {
                            "date": "2020-10-23",
                            "result": {
                                "keywords_count": {
                                    "value": 60
                                },
                                "ads_count": {
                                    "value": 60
                                },
                                "keywords_count_blocks": {
                                    "top": {
                                        "value": 44
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 16
                                    }
                                },
                                "avg_position_blocks": {
                                    "top": {
                                        "value": 1.1000000000000001
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 1.3999999999999999
                                    }
                                }
                            }
                        }
                    }
                },
                {
                    "domain": "comfy.ua",
                    "dates": {
                        "1": {
                            "date": "2020-10-22",
                            "result": {
                                "keywords_count": {
                                    "value": 13
                                },
                                "ads_count": {
                                    "value": 13
                                },
                                "keywords_count_blocks": {
                                    "top": {
                                        "value": 7
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 6
                                    }
                                },
                                "avg_position_blocks": {
                                    "top": {
                                        "value": 1
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 1
                                    }
                                }
                            }
                        },
                        "2": {
                            "date": "2020-10-23",
                            "result": {
                                "keywords_count": {
                                    "value": 28
                                },
                                "ads_count": {
                                    "value": 28
                                },
                                "keywords_count_blocks": {
                                    "top": {
                                        "value": 15
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 13
                                    }
                                },
                                "avg_position_blocks": {
                                    "top": {
                                        "value": 1
                                    },
                                    "sidebar": {
                                        "value": 0
                                    },
                                    "bottom": {
                                        "value": 1.2
                                    }
                                }
                            }
                        }
                    }
                }
            ]
        },
        "summary_info": {
            "page": 1,
            "page_total": 1,
            "count": 20,
            "total": 3,
            "sort": "domain",
            "order": "asc"
        },
        "spent_limits": 0
    }
}

Поделитесь статьей с вашими друзьями

Войти Регистрация

Вы исчерпали лимит запросов.

Или email
Забыли пароль?
Или email
Optional
Back To Login

Не волнуйтесь! Напишите свой электронный адрес и мы пришлем вам новый пароль.

Вы уверены?

Awesome!

To complete your registration you need to enter your phone number

Назад

Мы отправили код подтверждения на ваш номер телефона

Your phone Resend code Осталось запросов

Что-то пошло не так.

Свяжитесь с нашей службой поддержки
Или подтвердите регистрацию с помощью Телеграм бота Перейдите по этой ссылке
Выберите один из проектов

Знакомство с сервисом

Ознакомьтесь с основными возможностями Serpstat удобным способом!

Отправьте заявку для ознакомления с сервисом и мы свяжемся с вами в кратчайшие сроки. Наш специалист предложит подходящий вариант, который может включать персональную демонстрацию, пробный период, материалы для обучения и повышения экспертизы, личную консультацию, а также комфортные условия для начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Увеличить лимиты

Улучшить тариф

Экспорт недоступен для вашего тарифного плана. Вам необходимо улучшить свой тариф до Lite или выше, чтобы получить доступ к инструменту Подробнее

Зарегистрироваться

Спасибо, мы с вами свяжемся в ближайшее время

Пригласить
Просмотр Редактирование

E-mail
Сообщение
необязательно
E-mail
Сообщение
необязательно

У вас закончились лимиты

Вы достигли лимита на количество созданных проектов и больше не можете создавать новые проекты. Увеличьте лимиты или удалите существующие проекты.

Я хочу больше лимитов