Общая информация #
Раздел посвящен описанию методов API и их интерфейсов. API можно разделить на 2 большие части, это данные и справочники.
В этом разделе не будет приводиться информация о базовых параметрах запросов, а также полные структуры ответов. Для получения этой информации перейдите в раздел Работа с API.
Все методы принимают 2 не обязательных параметра:
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
| limit | Количество возвращаемых результатов, максимум 10000 | 1000 |
| offset | Cмещение по списку | 0 |
GET: api/v1/projects?{ops} #
Возвращает список, доступных пользователю, проектов.
Входные параметры #
Специальных параметров не требуется.
Возвращаемый результат #
В поле data будет возвращен массив объектов следующего вида:
{
id: number
name: string
url: string
}GET: api/v1/rivals?{ops} #
Возвращает список конкурентов для проекта.
Входные параметры #
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
| project_id | id проекта | нет |
Возвращаемый результат #
В поле data будет возвращен массив объектов следующего вида:
{
id: number
host: string
}GET: api/v1/pages?{ops} #
Возвращает список страниц проекта.
Входные параметры #
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
| project_id | id проекта | нет |
Возвращаемый результат #
В поле data будет возвращен массив объектов следующего вида:
{
id: number
name: string
url: string
categoryId: number
}GET: api/v1/engines?{ops} #
Возвращает список поисковых систем проекта.
Входные параметры #
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
| project_id | id проекта | нет |
Возвращаемый результат #
В поле data будет возвращен массив объектов следующего вида:
{
id: number
searcher: 'Yandex'|'Google'
region: string
devce: 'pc'|'mob'
}Типы частотности #
Возвращаемая частотность может быть 4х типов:
| Тип | Описание | Поисковая машина |
|---|---|---|
| 1 | Частота | |
| 5 | Частота | Yandex |
| 6 | «Частота» | Yandex |
| 8 | «!Частота» | Yandex |
GET: api/v1/categories?{ops} #
Возвращает список категорий (разделов) проекта.
Входные параметры #
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
| project_id | id проекта | нет |
Возвращаемый результат #
В поле data будет возвращен массив объектов следующего вида:
{
id: number
name: string
}GET: api/v1/checks?{ops} #
Возвращает список проверок проекта.
Входные параметры #
| Параметр | Описание | Значение по умолчанию |
|---|---|---|
| project_id | id проекта | нет |
Возвращаемый результат #
В поле data будет возвращен массив объектов следующего вида:
{
id: number
checkDate: string
serpEngineId: number
engineName: string
}