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 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”

  }

]

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

}]

Request format

DELETE https://api4.seranking.com/key-volume/{task_id}

If successful, the server returns HTTP 204.