Get Related Keywords

get

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

Returns thematically related keywords that share similar categories and themes with your seed keyword. This endpoint helps expand your keyword reach with relevant, competitive terms to broaden your content strategy and advertising opportunities.

Visualize this API live on SpyFu

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

query

string

required

Seed keyword to find thematically related keywords for.

includeTerms

string

Comma-separated list of terms that must be present in the keyword.

includeAnyTerm

boolean

Defaults to false

Used with includeTerms. If true: match any term (OR). If false: require all terms (AND).

excludeTerms

string

Comma-separated list of terms to exclude from results (e.g., branded or irrelevant terms).

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.

serpFirstResult

string

Filter to keywords where this specific domain ranks #1 in organic search results. Useful for identifying keywords where a particular competitor dominates.

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

pageSize

int32

1 to 10000

Defaults to 5

The maximum number of rows returned.

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

sortBy

string

enum

Defaults to null

Column to sort by.

Show Details

SearchVolume	Monthly search volume
LiveSearchVolume	Real-time search volume data
RankingDifficulty	SEO competition difficulty score
TotalMonthlyClicks	Estimated total monthly clicks
PercentMobileSearches	Percentage of searches from mobile devices
PercentDesktopSearches	Percentage of searches from desktop devices
PercentSearchesNotClicked	Percentage of searches resulting in no clicks
PercentPaidClicks	Percentage of clicks going to paid results
PercentOrganicClicks	Percentage of clicks going to organic results
BroadCostPerClick	Broad match cost per click estimate
PhraseCostPerClick	Phrase match cost per click estimate
ExactCostPerClick	Exact match cost per click estimate
BroadMonthlyClicks	Estimated monthly clicks for broad match
PhraseMonthlyClicks	Estimated monthly clicks for phrase match
ExactMonthlyClicks	Estimated monthly clicks for exact match
BroadMonthlyCost	Estimated monthly cost for broad match
PhraseMonthlyCost	Estimated monthly cost for phrase match
ExactMonthlyCost	Estimated monthly cost for exact match
PaidCompetitors	Number of paid search competitors
RankingHomepages	Number of homepages ranking organically

sortOrder

string

enum

Defaults to Descending

Order to sort the results.

Allowed:

startingRow

int32

1 to 10000

Defaults to 1

Row number to start the results with.

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 query 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 related keywords. Returns keyword data for thematically similar terms that share categories and themes, perfect for expanding content reach and competitive keyword targeting.