Phrase Match Keywords (keywords)

API v3 methods will be unavailable from 12/31/2021. Use a similar API v4 method.

The keywords method shows organic keywords associated with the researched keyword that domains are ranking for in Google`s top-100 results and for every found keyword you’ll see its volume, CPC and level of competition. The data set is similar to the Keyword research — SEO research — Keywords selection report.

General request parameters and instructions for using Serpstat API

Following parameters can be used for pagination:
page_size: number of results per page (default: 100, max: 1000);
page: page number (set to the 1st page by default).

You can use the following parameters to filter the results:

Parameter	Description	Possible settings
queries_from	min number of monthly searches	0-100,000,000
queries_to	max number of monthly searches	0-100,000,000
cost_from	min CPC	0-200
cost_to	max CPC	0-200
concurrency_from	min level of competition	1-100
concurrency_to	max level of competition	1-100
minus_keywords	filtering by negative keywords (separated by commas)	string
right_spelling	filtering by misspelled keywords	not_contains - contains misspelled keywords; contains - does not contain misspelled keywords

To sort the results apply the following parameters:
sort: field that needs to be sorted;
order: sorting order (asc - ascending, desc - descending).

Response parameters
Parameter	Description
result	Contains the answer
total	Number of found results
hits	Contains the answer
keyword	Specified keyword
cost	Cost per click, $
concurrency	Keyword competition in PPC (0-100%)
found_results	The number of results found for the keyword
region_queries_count	Search volume in selected search engine database
types	A list of special elements shown in SERP (for example, video, carousel or map)
geo_names	List of toponyms in the array (if toponyms are present in the keywords)
social_domains	Social domains (Facebook, Youtube,etc.) which rank for a keyword in top-10
right_spelling	Proposed correction for a keyword with a spelling error
keyword_length	Number of words divided by space in a keyword
lang	Language
keyword_length	Number of words divided by space in a keyword
difficulty	The assessment of the level of competition for a keyword to advance in organic search in the top-10 (from 0 to 100%)
status_msg	Response "OK" or "Error" report on a successful or unsuccessful request
status_code	Response code "200" — successful request. Errors occur when credits are exceeded (number of simultaneous requests or account credits)
left_lines	API credits remaining

Part of the API response for which you spend 1 credit:

{
    "keyword": "iphone 11",
    "keyword_id": "76373283",
    "cost": 0.7,
    "concurrency": 100,
    "found_results": 96,
    "region_queries_count": 2240000,
    "types": [
        "also_asks",
        "ads_top"
        ],
    "geo_names": [],
    "social_domains": [
        "wikipedia",
        "pinterest",
        "reddit",
        "amazon"
        ],
    "right_spelling": null,
    "lang": null,
    "keyword_length": 2,
    "difficulty": 30.39
},

Example

Request data:

api.serpstat.com/v3/keywords?query=iphone&token=XXX&se=g_us

Response data:

{
    "result": {
        "total": 8323766,
        "hits": [
            {
                "keyword": "iphone 11",
                "keyword_id": "76373283",
                "cost": 0.7,
                "concurrency": 100,
                "found_results": 96,
                "region_queries_count": 2240000,
                "types": [
                    "also_asks",
                    "ads_top"
                ],
                "geo_names": [],
                "social_domains": [
                    "wikipedia",
                    "pinterest",
                    "reddit",
                    "amazon"
                ],
                "right_spelling": null,
                "lang": null,
                "keyword_length": 2,
                "difficulty": 30.39
            },
            {
                "keyword": "iphone 1 1",
                "keyword_id": "128864865",
                "cost": 0.7,
                "concurrency": 100,
                "found_results": 81,
                "region_queries_count": 2240000,
                "types": [
                    "also_asks",
                    "shopping_top"
                ],
                "geo_names": [],
                "social_domains": [
                    "wikipedia",
                    "amazon",
                    "reddit"
                ],
                "right_spelling": null,
                "lang": null,
                "keyword_length": 3,
                "difficulty": 84.69767683592724
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999738
}