Sending keywords with commas to crawl regular SERP and local results as an array

The tasks.addKeywordList method allows sending keywords with commas to crawl regular SERP and local results as an array.

Note: Google AI Overview results are currently available within standard Desktop SERP Crawling requests at no additional cost. This allows you to access AI-generated summaries and reference sources as part of your regular SERP data. However, starting August 1, 2025, AI Overview data will become a separate optional parameter with additional pricing. After this date, you will need to specifically enable AI Overview in your API requests and account for the additional costs in your usage billing.

General request parameters and instructions for using Serpstat API

Request parameters for regular results
Parameter	Description	Type	Optional	Default value	Value options
id	The identifier of a current request, can be set manually or automatically	string	no		1, test
method	API method name	string	no		tasks.addKeywordList
params	Object with parameters	object	no
keywords	Keywords with commas for parsing	array	no		["samsung, iphone", "nike, adidas"]
seId	Search engine identifier	int	no		1 — Google
countryId	Country identifier. Country (for Google) is indicated in the document	int	no		23 (USA)
regionId	Region or city identifier. Region is indicated in the document	int	yes — Google		21176 (Texas)
langId	Language identifier. Language is indicated in the document	int	no		1 (English)
typeId	Device type identifier	int	yes	Desktop	1 — Desktop 2 — Mobile
Local results There is a special block in Google SERP Local pack that usually consists of 3 results (sometimes there can be 4 results and the first one is ad). If you click on the "More places" button in the bottom of the Local pack block, you will see the Local results page that includes the same data as the Local pack but it has more results (up to 50 results for both desktop and mobile). To get this data, you need to add the following parameter in the query:
type	Type of Google results	string	yes	By default the parameter is "regular"; "local" — for local results	local
The example of the request for Local results: `{ "id": "some_id" , "method": "tasks.addKeywordList", "params": { "keywords": ["samsung, iphone", "nike, adidas"], "typeId": 1, "seId": 1, "countryId": 23, "langId": 1, "type": "local" } }`

Response parameters
Parameter	Description
id	Identifiers of the current request
result	Contains the answer
task_id	Crawling identifier
blocked_keywords	Keywords with special symbols, which were rejected, credits won’t be charged

Errors
Error	Description
You have no keywords after filtrating, blocked keywords: [list of blocked keywords]	If all sent keywords were invalid
Required parameter '[parameter]' missed	A parameter is missed
Task (id=x) with such parameters has already been created today	You have already created a task with such parameters
No such se_id	Invalid se_id
device_type_id Invalid type id value	Invalid type_Id

Example Python

Request data:

{
    "id": "some_id" ,
    "method": "tasks.addKeywordList",
    "params": {
         "keywords": ["samsung, iphone", "nike, adidas"],
         "typeId": 1,
         "seId": 1,
         "countryId":  23,
         "langId": 1
     }
}

Response data:

{
    "id": "some_id",
    "result": {
        "task_id": "2071492",
        "blocked_keywords": []
    }
}

Serpstat API request drafts: link