Use your Black Friday discount until December 4thLearn more

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
queryYes 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.