Keyword Research

Getting data on keywords

Description

The method allows getting various data on keywords.

Request format

Title of the code block

Copy

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

Title of the code block

Copy

[

    {

        is_data_found: true,

        keyword: "seranking.com",

        volume: 10,

        cpc: 0.0,

        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	Exceeded keywords size. Max keywords for one request: 10000
400	Invalid keywords
400	Invalid source