Keyword Research API
Getting data on keywords
Description
The method allows getting various data on keywords.
Request format
POST https://api4.seranking.com/research/{source}/analyze-keywords/Parameters
| Name | Required | Description |
| source | Yes | Alpha-2 code of the country you’re checking |
| keywords | Yes | Keywords to analyze. 5,000 max per single request. |
| sort | No | Sorting (CPC by default) |
| sort_order | No | Sorting order: asc or desc (desc by default) |
| cols | No | The list of return values (separated by commas) |
Result
If successful, the server returns the list of keywords with their parameters.
Example
[
{
is_data_found: true,
keyword: “seranking.com”,
volume: 10,
cpc: 0.00,
competition: “0.00”,
difficulty: 90,
history_trend: {
“2020-03-01”: 10,
“2020-04-01”: 10,
“2020-05-01”: 10,
“2020-06-01”: 10,
“2020-07-01”: 10,
“2020-08-01”: 10,
“2020-09-01”: 10,
“2020-10-01”: 10,
“2020-11-01”: 10,
“2020-12-01”: 10,
“2021-01-01”: 10,
“2021-02-01”: 10
}
},
…
]Response parameters
| Name | Description |
| is_data_found | Shows whether keyword id data is found: values are either true or false |
| keyword | Keyword |
| volume | Search volume |
| cpc | CPC |
| competition | Competition |
| difficulty | Keyword difficulty |
| history_trend | Search volume history |
Errors
| HTTP code | Error message |
| 400 | Incorrect order field {sort} {sort_order} |
| 400 | Number of keywords exceeded. Max keywords per single request: 5000 |
| 400 | Invalid keywords |
| 400 | Invalid source |