Search volume check API
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 |
Result
If successful, the server returns the request ID for checking.
Response example
{
“id”:1
}
Errors
HTTP code | Error message |
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.