API

Search volume

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

Copy

POST https://api4.seranking.com/key-volume/

Parameters

If the region id is passed, the check is performed via Google.

Name	Required	Description
query	Yes	Search query or a query array

Result

If successful, the server returns the request ID for checking.

Response example

Copy

{

  "id":1

}

Errors

HTTP code	Error message
400	Invalid

Request format

Copy

GET https://api4.seranking.com/key-volume/

Result

If successful, the server returns the request list for the search volume check.

Response example

Copy

[{

  "id":1,

  "add_time": "2018-08-15 12:51:21",

  "total_queries" : 1,

  "total_finished" : 1,

  "country" : "USA"

}]

Request format

Copy

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.

Copy

{

  "status" : "processing"

}

If the result is ready.

Copy



[{

  "query": "query 1",

  "volume": 2342

}]

Request format

Copy

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

Result

If successful, the server returns HTTP 204.