Bulk Keywords API (V1)

The Bulk Keywords API endpoint enables you to research up to 50 keywords at the same time to find their aggregated search metrics such as volume, cpc, advertising competition, trailing 12 month history, and more. We use the global Google index instead of segmenting the data by region or country.

• Endpoint cost is 1 credit / keyword for successful requests

Input processing

When you provide a list of keywords to this endpoint, we sanitize each of them in line with how Google typically processes queries:

• Leading and trailing empty spaces are removed: ' foo ' --> 'foo'

• Multiple consecutive spaces are collapsed: 'foo bar' --> 'foo bar'

• Character unification: In some cases 'foo-bar' might return similar data to 'foo bar'

• Keyword matching: We expect that you provide all your keywords as UTF-8 encoded strings --> ex mjölk

Request Parameters

• API Endpoint: POST https://serpgrid.dev/v1/keywords/bulk

• Required headers: X-API-KEY and Content-Type

Request Example

Bulk Keywords Request

// Example request curl -L 'https://api.serpgrid.dev/v1/keywords/bulk' \ -H 'X-API-KEY: {API_KEY}' \ -H 'Content-Type: application/json' \ -d '{"keywords": ["SEO Tools", "mjölk"]}'

Bulk Keywords Response

// Example response { "http_code": 200, "http_message": "Ok", "timestamp": 1752961588, "execution_ms": 519, "message": "Successful execution", "payload": { "keywords": [ { "keyword": "SEO Tools", "normalized": "seo tools", "length": 9, "engine": "google.com", "url": "https://google.com/search?q=seo+tools", "volume": 90500, "competition": 9, "currency": "USD", "cpc": 0.52, "ttm_history": [ { "date": "07-2024", "date_alpha": "July 2024", "volume": 74000 }, { "date": "08-2024", "date_alpha": "August 2024", "volume": 74000 }, { "date": "09-2024", "date_alpha": "September 2024", "volume": 74000 }, { "date": "10-2024", "date_alpha": "October 2024", "volume": 90500 }, { "date": "11-2024", "date_alpha": "November 2024", "volume": 74000 }, { "date": "12-2024", "date_alpha": "December 2024", "volume": 74000 }, { "date": "01-2025", "date_alpha": "January 2025", "volume": 90500 }, { "date": "02-2025", "date_alpha": "February 2025", "volume": 90500 }, { "date": "03-2025", "date_alpha": "March 2025", "volume": 110000 }, { "date": "04-2025", "date_alpha": "April 2025", "volume": 110000 }, { "date": "05-2025", "date_alpha": "May 2025", "volume": 165000 }, { "date": "06-2025", "date_alpha": "June 2025", "volume": 135000 } ] }, { "keyword": "mjölk", "normalized": "mjölk", "length": 5, "engine": "google.com", "url": "https://google.com/search?q=mj%C3%B6lk", "volume": 22200, "competition": 34, "currency": "USD", "cpc": 0.41, "ttm_history": [ { "date": "07-2024", "date_alpha": "July 2024", "volume": 18100 }, { "date": "08-2024", "date_alpha": "August 2024", "volume": 14800 }, { "date": "09-2024", "date_alpha": "September 2024", "volume": 18100 }, { "date": "10-2024", "date_alpha": "October 2024", "volume": 18100 }, { "date": "11-2024", "date_alpha": "November 2024", "volume": 18100 }, { "date": "12-2024", "date_alpha": "December 2024", "volume": 22200 }, { "date": "01-2025", "date_alpha": "January 2025", "volume": 22200 }, { "date": "02-2025", "date_alpha": "February 2025", "volume": 40500 }, { "date": "03-2025", "date_alpha": "March 2025", "volume": 14800 }, { "date": "04-2025", "date_alpha": "April 2025", "volume": 18100 }, { "date": "05-2025", "date_alpha": "May 2025", "volume": 18100 }, { "date": "06-2025", "date_alpha": "June 2025", "volume": 18100 } ] } ] } }

Additional Information

The following headers will also be returned as part of the response to you:

• X-Credits-Remaining The number of credits that remain in your account
• X-Credits-Expire A datetime string with the expiration date
• X-Credits-Used The number of credits the operation consumed

Errors are handled in line with our Error Rules. Please make sure to read it carefully and follow the instructions for the best experience possible.