Keyword groups
Creating a group of keywords
The method allows to add a group for project keywords.
Parameters
| Name | Required | Description |
| name | Yes | Name of the project keyword group to be added |
| site_id | Yes | ID of the project to which a keyword group will be added |
Request format
| POST https://api4.seranking.com/keyword-groups {“name”: “groupname”,”site_id”: 1} |
Result
If successful, the server returns the 201 HTTP code and an array containing the ID of the added project keyword group.
| Name | Required | Description |
| group_id | Yes | ID of the added project keyword group |
Response example
| { “group_id”: 123456 } |
Errors
| HTTP code | Error message |
| 404 | Empty name |
| 404 | Empty site_id |
Moving keywords to another group
The method allows to transfer project keywords from one group to another.
Parameters
| Name | Required | Description |
| keywords_ids | Yes | Array of the IDs of keywords to be transferred |
Request format
| POST /keyword-groups/{group_id}/keywords {“keywords_ids”: [1,2,3,4,5]} |
Result
If successful, the server returns the 204 HTTP code.
Errors
| HTTP code | Error message |
| 404 | Group not found |
Renaming a keyword group
The method allows to change the name of a project keyword group.
Parameters
| Name | Required | Description |
| name | Yes | New keyword group name |
Request format
| PUT /keyword-groups/{group_id} {“name”: “new name”} |
Result
If successful, the server returns the 204 HTTP code.
Errors
| HTTP code | Error message |
| 404 | Empty name |
| 404 | Group not found |
Deleting a keyword group
The method allows to delete a project keyword group.
Request format
| DELETE /keyword-groups/{group_id} |
Result
If successful, the server returns the 204 HTTP code.
Errors
| HTTP code | Error message |
| 404 | Group not found |
Getting a list of keyword groups
The method allows to get a list of of keyword groups for a specified project.
Request format
| GET /keyword-groups/{site_id} |
Result
If successful, the server returns an array of keyword groups for the specified project.
| Name | Required | Description |
| id | Yes | Project keyword group ID |
| name | Yes | Project keyword group name |
| creation_date | Yes | Date of creation of a project keyword group |
Response example
| [ { “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” } ] |
Errors
| HTTP code | Error message |
| 400 | No keywords ids in request |
| 404 | Group not found |