Get New PPC Keywords

get

https://api.spyfu.com/apis/keyword_api/v2/ppc/getNewKeywords

Returns newly acquired paid search keywords that a domain has started advertising on for the first time. This endpoint identifies recent keyword expansions and emerging advertising strategies to reveal new market opportunities and competitive moves.

Visualize this API live on SpyFu

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

query

string

required

Domain or URL to analyze for new PPC keywords.

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).

excludeDomain

string

Domain to exclude from keyword results.

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.

adCount.min

float

Filter by the number of total advertisers

adCount.max

float

Filter by the number of total advertisers

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:

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.

wordCount.min

float

Filter by the number of words in the keyword.

wordCount.max

float

Filter by the number of words in the keyword.

pageSize

int32

1 to 10000

Defaults to 5

The maximum number of rows returned.

countryCode

string

enum

Defaults to US

Country to get results for.

sortBy

string

enum

Defaults to SearchVolume

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

Sort direction for 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., invalid domain format, search volume ranges, or invalid country code)

401

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

500

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

200Successfully retrieved new PPC keywords. Returns keyword data with search metrics, cost estimates, and competitive intelligence showing recently acquired paid keywords for strategic expansion insights.