nofollow

Конкуренты

Добавление конкурента в проект

Метод позволяет добавить сайт конкурента в проект для отслеживания позиций.

Параметры

Имя Обязательный Описание
site_id Да Уникальный идентификатор проекта
url Да URL сайта конкурента
name Нет Имя сайта конкурента (если не указать, будет использован url)
subdomain_match нет Учитывать сабдомены (1 – да , 0 – нет)

Формат запроса

POST /competitors
{
    site_id : 1,
    name : "name",
    url : "http://site.test.com/"
}

Результат

В случае успеха сервер возвращает HTTP 201 и id добавленного конкурента.

Имя Обязательный Описание
id Да Уникальный идентификатор добавленного конкурента в проект

Пример ответа

{
    "id": 123456
}

Ошибки

HTTP-код Сообщение об ошибке
400 Invalid site url

Получение списка конкурентов проекта

Метод позволяет получить список всех конкурентов добавленных в проект.

Формат запроса

GET /competitors/site/{site_id}

Результат

В случае успеха сервер возвращает массив со списком конкурентов, добавленных в проект, и статистику по сайтам конкурентов.

Имя Обязательный Описание
id Да ID конкурента
name Да Название конкурента
url Да URL конкурента

Пример ответа

[
    {
        "id": 1,
        "name": "competitor1.com",
        "url": "competitor1.com",
    },
    {
        "id": 2,
        "name": "competitor2.com",
        "url": "http://competitor2.com/",
    },
    {
        "id": 3,
        "name": "competitor3.com",
        "url": "http://competitor3.com",
    }
]

Позиции по ключевым словам конкурентов

Метод позволяет получить статистику проверки позиций по ключевым словам конкурента, добавленного в проект.

Формат запроса

GET /competitors/{competitor_id}/positions?date_from=2018-07-25&date_to=2018-07-25&site_engine_id=1

Query-параметры запроса

Имя Обязательный Тип Описание
date_from Нет yyyy-mm-dd Дата начала периода (по умолчанию – сегодня минус неделя)
date_to Нет yyyy-mm-dd Дата конца периода (по умолчанию – сегодня)
site_engine_id Нет yyyy-mm-dd ID поисковой системы, для которой надо получить статистику. Если не указан – отображается для всех поисковиков сайта

Результат

В случае успеха сервер возвращает массив со статистикой позиций по ключевым словам конкурента, добавленного в проект.

Имя Обязательный Описание
id Да ID ключевого слова, добавленного в проект
positions Да Массив позиций, содержащий статистику позиций по ключевым словам конкурента
date Да Дата проверки позиций по ключевым словам
change Да Изменение позиции по сравнению с предыдущей датой (может быть отрицательное)
pos Да Текущая позиция

Пример ответа

[
    {
        "site_engine_id": 123,
        "keywords": [
            {
                "id": "123",
                "positions": [
                {
                    "date": "2018-07-25",
                    "pos": 7,
                    "change": 1
            }
        ],
        "name": null,
        "volume": null
    },
    ...
]

Ошибки

HTTP-код Сообщение об ошибке
400 Invalid site_engine_id
404 Incorrect competitor id

Удаление конкурента из проекта

Метод позволяет удалить сайт конкурента из проекта пользователя.

Формат запроса

DELETE /competitors/{competitor_id}

Результат

В случае успеха сервер вернет HTTP 204.

Ошибки

HTTP-код Сообщение об ошибке
404 Incorrect competitor id

Получение ТОП 10 по ключевому слову

Метод позволяет получить список результатов из ТОП 10 по ключевым словам, отслеживаемым в проекте.

Формат запроса

GET /competitors/top10/{site_id}/?date=2018-01-01&site_engine_id=1&keyword_id=1

Query-параметры запроса

Имя Обязательный Тип Описание
date Да yyyy-mm-dd Дата получения списка сайтов из ТОП 10
site_engine_id Да Идентификатор поисковой системы
keyword_id Нет Идентификатор ключевого слова, добавленного в проект (для получения используйте GET /sites/{site_id}/keywords). Если не указан, ТОП 10 будет возвращен для всех ключевых слов проекта

Результат

В случае успеха сервер возвращает массив со списком сайтов из ТОП 10.

Имя Описание
url URL страницы
position Позиция в поисковой выдаче
keyword_id Уникальный идентификатор ключевого слова
alexa Alexa
da Moz Domain Authority
backlinks Суммарное количество бэклинков
domains Количество ссылающихся уникальных доменов
yandex_x Индекс качества сайта. Показывает, насколько полезен сайт конкурента для пользователей с точки зрения Яндекса

Пример ответа

[
    {
        "url": "https://www.tests.com/login",
        "position": 1,
        "keyword_id": 1,
        "alexa": "46890",
        "da": null,
        "backlinks": "328",
        "domains": "32",
        "yandex_x": null
    },

    ...
]

Получение ТОП 100 по ключевому слову

Метод позволяет получить список результатов из ТОП 100 по ключевым словам, отслеживаемым в проекте.

GET /competitors/top100/{site_id}/?date=2018-01-01&site_engine_id=1&keyword_id=1

Query-параметры запроса

Имя Обязательный Тип Описание
date Да yyyy-mm-dd Дата
site_engine_id Да Идентификатор поисковой системы
keyword_id Да Идентификатор ключевого слова, добавленного в проект (для получения используйте GET /sites/{site_id}/keywords)
top Нет 0 .. 100 Максимальная позиция

Результат

В случае успеха сервер возвращает массив со списком сайтов из ТОП 100.

Имя Описание
url URL страницы
position Позиция в поисковой выдаче
date Дата проверки позиции

Пример ответа

[
    {
        "url": "https://www.tests.com/login",
        "position": 1,
        "date": "2018-01-01"
    },
    {
        "url": "https://www.test2.com,
        "position": 2,
        "date": "2018-01-01"
    },


    ...
]

Все конкуренты

Информация о сайтах, которые были в ТОП-10 по каждому из отслеживаемых запросов. История сохраняется 14 дней.

Формат запроса

GET /competitors/all/{site_id}/?date=2018-01-01&site_engine_id=1&group_id=1&tags[]=21

Query-параметры запроса

Имя Обязательный Тип Описание
date Да yyyy-mm-dd Дата получения списка сайтов из ТОП 10
site_engine_id Нет Идентификатор поисковой системы. Если не указан, вернёт данные для всех поисковых систем
group_id Нет Идентификатор группы ключевых слов. Если не указан, вернёт данные для всех
tags Нет Массив тегов

Результат

В случае успеха сервер возвращает массив со списком сайтов из ТОП 10.

Имя Описание
domain_id ID домена
domain Домен сайта конкурента
visibility Видимость конкурента
alexa Alexa
da Moz Domain Authority
backlinks Суммарное количество бэклинков
domains Количество ссылающихся уникальных доменов
yandex_x Индекс качества сайта. Показывает, насколько полезен сайт конкурента для пользователей с точки зрения Яндекса

Пример ответа

[
    {
        "domain": "www.tests.com",
        "domain_id": 10,
        visibility": 0,
        "alexa": "46890",
        "da": null,
        "backlinks": "328",
        "domains": "32",
        "yandex_x": null
    },

...
] 

Отличный сервис для работы с клиентами

Использование сервиса дало нам возможность автоматизировать ручной труд в процессе продвижения своих и Клиентских проектов. Приятно радуют регулярные обновления, которые закрывают все потребности думающего специалиста.
people Андрей Гусаров Владелец агентства
GUSAROV

Удобный сервис для снятия позиций и анализа данных

Сервисом довольны, он позволяет автоматизировать сбор позиций и анализировать динамику большого количества сайтов, продвигаемых нашей компанией.
Радуют постоянные работы, направленные на улучшение работы сервиса и расширение его функционала.
people Владимир Ведущий SEO-специалист
ООО Россайт

Must have инструмент для интернет-агентств

Несколько раз пытались начать работать с сервисом, но всегда что-то останавливало.
Сейчас перевели все проекты к вам. Всем довольны. Используем в качестве мониторинга позиций и анализа сниппетов. Must have. Спасибо!
people Сергей Новицкий Генеральный директор
интернет-агентства Brandmaker

Точная проверка позиций

Лучший сервис по проверке позиций в Рунете. Приятно удивил не только очень быстрой и 100% точной проверкой позиций, но и наличием мощного инструментария по аналитике запросов и аудиту сайтов.
people Юрий Макаров SEO-специалист,
блогер

Многофункциональная и удобная в использовании SEO-платформа

В первую очередь использую сервис для отслеживания позиций своего сайта и анализа позиций конкурентов по тем же ключевым запросам. Настройки очень гибкие, даже не знаю, что бы я туда хотел добавить. Отображение что табличных данных, что графиков сделано со вкусом, дизайнерам и разработчикам за это огромное спасибо. Использую уже не один месяц, а любоваться не перестаю :-) Касаемо же точности данных в этом модуле - тоже никаких нареканий, периодически вручную проверяю некоторые позиции, всё совпадает в большинстве случаев
people Соколянский Виктор SEO-специалист, АртВеб

Хороший сервис, рекомендую.

Сервисом пользуюсь уже два месяца, в основном меня интересует съем позиций и анализ конкурентов, мониторинг позиций, анализ слабых мест сайта. Пользуюсь не долго, к новому интерфейсу нужно немного привыкнуть, а так все удобно и все что нужно для работы есть, гибкие настройки позволяют делать наглядные отчеты и таблицы позиций для клиента. Да и еще, я сам выбрал этот сервис по рекомендации другого человека, пользовавшегося им.
people Щоцкий Александр Директор в SEO-агентстве
Cropas.by
С нами уже 300 000 клиентов
Вы в хорошей компании
  • wargaming company logo
  • bed bath & beyond company logo
  • zapier company logo
  • hunter engeenering logo
  • trustpilot company logo
  • cars.com company logo
Попробовать 2 недели бесплатно