nofollow
BLACKFRIDAY2018

-30% скидки на любую оплату
подробнее

Черная пятница в SE Ranking: 30% скидки на любую оплату. подробнее

Группы ключевых слов

Добавление группы для ключевых слов

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

Параметры

Имя Обязательный Описание
name Да Имя добавляемой группы для ключевых слов проекта
site_id Да ID проекта, в который будет добавлена группа для ключевых слов

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

POST https://api4.seranking.com/keyword-groups
{
    "name": "groupname",
    "site_id": 1
}

Результат

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

Имя Обязательный Описание
group_id Да ID добавленной группы для ключевых слов проекта

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

{
    "group_id": 123456
}

Ошибки

HTTP-код Сообщение об ошибке
404 Empty name
404 Empty site_id

Перенос ключевых слов в другую группу

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

Параметры

Имя Обязательный Описание
keywords_ids Да Массив ID переносимых ключевых слов

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

POST /keyword-groups/{group_id}/keywords
{
    "keywords_ids": [1,2,3,4,5]
}

Результат

В случае успеха сервер возвращает HTTP 204.

Ошибки

HTTP-код Сообщение об ошибке
404 Group not found

Изменение названия группы ключевых слов

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

Параметры

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

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

PUT /keyword-groups/{group_id}
{
    "name": "new name"
}

Результат

В случае успеха сервер возвращает HTTP 204.

Ошибки

HTTP-код Сообщение об ошибке
404 Empty name
404 Group not found

Удаление группы ключевых слов

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

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

DELETE /keyword-groups/{group_id}

Результат

В случае успеха сервер возвращает HTTP 204.

Ошибки

HTTP-код Сообщение об ошибке
404 Group not found

Получение списка групп ключевых слов

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

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

GET /keyword-groups/{site_id}

Результат

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

Имя Обязательный Описание
id Да ID группы ключевых слов проекта
name Да Название группы ключевых слов проекта
creation_date Да Дата создания группы ключевых слов проекта

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

[
    {
        "id": "123",
        "name": "NewKeyGroup",
        "creation_date": "2018-08-27"
    },
    {
        "id": "456",
        "name": "NewKeyGroup1",
        "creation_date": "2018-08-27"
    },
    {
        "id": "789",
        "name": "NewKeyGroup2",
        "creation_date": "2018-08-27"
    }
]

Ошибки

HTTP-код Сообщение об ошибке
404 No keywords ids in request
404 Group not found