Get Keyword Information Bulk

get

https://api.spyfu.com/apis/keyword_api/v2/related/getKeywordInformation

Returns comprehensive keyword metrics and intelligence for a list of exact keywords. This endpoint provides search volume, competition data, cost estimates, and performance insights for specific keywords you want to analyze in bulk.

Visualize this API live on SpyFu

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

keywords

string

required

Comma-separated list of exact keywords to retrieve information for.

searchVolume.min

float

Filter by the number of searches done this past month on Google.

searchVolume.max

float

Filter by the number of searches done this past month on Google.

liveSearchVolume.min

float

Filter by the number of searches done this past month on Google. This value is refreshed each month.

liveSearchVolume.max

float

Filter by the number of searches done this past month on Google. This value is refreshed each month.

keywordDifficulty.min

float

Filter by how difficult it is to rank on this keyword. This can also be called Ranking Difficulty.

keywordDifficulty.max

float

Filter by how difficult it is to rank on this keyword. This can also be called Ranking Difficulty.

costPerClick.min

float

Filter by the average cost per click. This will use the keyword matching option selected in costPerClickOption

costPerClick.max

float

Filter by the average cost per click. This will use the keyword matching option selected in costPerClickOption

costPerClickOption

string

enum

Cost per click keyword matching option to filter results by.

Allowed:

wordCount.min

float

Filter by the number of words in the keyword.

wordCount.max

float

Filter by the number of words in the keyword.

clicks.min

float

Filter by the number of total monthly clicks on the SERP for this keyword--organic and paid.

clicks.max

float

Filter by the number of total monthly clicks on the SERP for this keyword--organic and paid.

isQuestion

boolean

Defaults to false

Filter on if the keyword is a question.

isTransactionalIntent

boolean

Defaults to false

Filter on if the keyword has transactional intent.

mobileSearchesPercentage.min

float

Filter by the percentage of searches that are done on mobile devices.

mobileSearchesPercentage.max

float

Filter by the percentage of searches that are done on mobile devices.

desktopSearchesPercentage.min

float

Filter by the percentage of searches that are done on desktop devices.

desktopSearchesPercentage.max

float

Filter by the percentage of searches that are done on desktop devices.

notClickedSearchesPercentage.min

float

Filter by the percentage of searches that are not clicked. Some keyword searches supply clear information in a featured snippet or similar displays. They don't require a click to get the information. Those will have higher percentages in this metric.

notClickedSearchesPercentage.max

float

paidClickSearchPercentage.min

float

Filter by the percentage of clicks that go to ads.

paidClickSearchPercentage.max

float

Filter by the percentage of clicks that go to ads.

organicClicksSearchPercentage.min

float

Filter by the percentage of clicks that go to organic results, not ads.

organicClicksSearchPercentage.max

float

Filter by the percentage of clicks that go to organic results, not ads.

monthlyCost.min

float

Filter by the monthly cost of the keyword. This will use the keyword matching option selected in monthlyCostOption

monthlyCost.max

float

Filter by the monthly cost of the keyword. This will use the keyword matching option selected in monthlyCostOption

monthlyCostOption

string

enum

Monthly Cost keyword matching option to filter results by.

Allowed:

rankingHomepages.min

float

Homepages on the SERP range to filter results by.

rankingHomepages.max

float

Homepages on the SERP range to filter results by.

adCount.min

float

Filter by the number of total advertisers

adCount.max

float

Filter by the number of total advertisers

countryCode

string

enum

Defaults to US

Country market to search. Specifically, this maps to the Google domain version to query against (e.g., google.com for US, google.de for Germany, etc.). All Countries

adultFilter

boolean

Defaults to true

Exclude adult keywords considered unsafe for work.

onlyAdultKeywords

boolean

Defaults to false

Only include adult keywords considered unsafe for work.

Responses

400

Bad Request - Invalid parameters provided (e.g., malformed keyword list or invalid country code)

401

Unauthorized - Invalid API credentials or insufficient permissions to access keyword research data

500

Internal Server Error - A server-side error occurred while processing the request

200Successfully retrieved keyword information. Returns comprehensive metrics including search volume, competition levels, cost estimates, and performance data for each requested keyword.