Table of content
世界杯买球站
Adding a volume check request
Description
The method allows adding a request to check a search volume. Checking one keyword costs $0.005. Checking a few keywords (from 2 to 700) costs $0.2.
Request format
POST https://api4.seranking.com/key-volume/
Parameters
If the region id is passed, the check is performed via Google. If the Yandex region and type are passed, the check is done via Yandex.
| Name | Required | Description |
| query | Yes | Search query or a query array |
| region_id | Yes | id from the region list /system/volume-regions |
| yandex_region_code | Yes – if region_id is missing | id from the region list /system/yandex-regions |
| type | Yes – if region_id is missing |
broad – Wide
phrase – «Phrase» exact – «!Exact» |
Result
If successful, the server returns the request ID for checking.
Response example
{
id:1
}
Errors
| HTTP code | Error message |
| 400 | Invalid region id |
| 400 | Invalid |
Request list
Request format
GET https://api4.seranking.com/key-volume/
Result
If successful, the server returns the request list for the search volume check.
Response example
[
{
‘id’:1,
‘add_time’: ‘2018-08-15 12:51:21’,
‘total_queries’ : 1,
‘total_finished’ : 1,
‘country’ : ‘USA’
}
]
Check results
Request format
GET https://api4.seranking.com/key-volume/{task_id}
Result
The server returns the check result or status.
Response example
If the result has not been received yet.
{
‘status’ : ‘processing’
}
If the result is ready.
[{
‘query’: ‘query 1’,
‘volume’: 2342
}]
Deleting a volume check request
Request format
DELETE https://api4.seranking.com/key-volume/{task_id}
Result
If successful, the server returns HTTP 204.