API для групп ключевых слов

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

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

Параметры

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

POST https://api4.seranking.com/keyword-groups

{

"name": "groupname",

"site_id": 1

}

Результат

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

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

{ "group_id": 123456}

Ошибки

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

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

Параметры

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

POST /keyword-groups/{group_id}/keywords

{

"keywords_ids": [1,2,3,4,5]

}

Результат

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

Ошибки

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

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

Параметры

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

PUT /keyword-groups/{group_id}

{

"name": "new name"

}

Результат

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

Ошибки

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

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

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

DELETE /keyword-groups/{group_id}

Результат

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

Ошибки

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

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

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

GET /keyword-groups/{site_id}

Результат

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

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

[

{

"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"

}

]

Ошибки