FREE MARKETING MARATHON: How to stop panicking and start taking action Join now

Search volume check

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 
region_idYes 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 missingbroad – 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.