SpyFu · Schema
SpyFu PPC Research API Schemas
JSON Schema definitions for SpyFu PPC Research API API responses
SEOPPCCompetitive IntelligenceKeyword ResearchAd HistoryBacklinksDomain AnalyticsSERP
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "SpyFu PPC Research API Schemas",
"description": "JSON Schema definitions for SpyFu PPC Research API API responses",
"definitions": {
"PaidSerpApi_GetMostSuccessful_GET": {
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Get Most Profitable PPC Keywords",
"description": "Response wrapper containing PPC keyword research data with detailed advertising performance metrics and pagination metadata for keyword discovery and optimization.",
"type": "object",
"properties": {
"resultCount": {
"description": "Number of results returned",
"type": "integer",
"format": "int32",
"examples": [
100
],
"readOnly": true
},
"totalMatchingResults": {
"description": "Total number of PPC keywords available that match the query criteria, including results not included in the current page.",
"type": "integer",
"format": "int64",
"examples": [
75000
],
"readOnly": true
},
"results": {
"description": "Array of PPC keywords with comprehensive advertising performance metrics including search volume, cost data, and competitive intelligence insights.",
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "The keyword that shows high performance or profitability for successful competitors in paid search advertising.",
"type": [
"string",
"null"
],
"examples": [
"running shoes"
]
},
"searchVolume": {
"description": "Estimated monthly search volume for this keyword based on Google search data across the selected country/region, blended from multiple sources for accuracy.",
"type": [
"integer",
"null"
],
"format": "int64",
"examples": [
266000
]
},
"liveSearchVolume": {
"description": "Adjusted search volume based on recent trends and real-time data, providing a more current estimate than historical averages.",
"type": [
"integer",
"null"
],
"format": "int64",
"examples": [
82000
]
},
"rankingDifficulty": {
"description": "SEO difficulty score (0-100) indicating how challenging it would be to rank organically for this keyword, with 100 being most difficult.",
"type": [
"integer",
"null"
],
"format": "int32",
"examples": [
98
]
},
"totalMonthlyClicks": {
"description": "Total estimated monthly clicks (both organic and paid) generated from search results for this keyword.",
"type": [
"integer",
"null"
],
"format": "int64",
"examples": [
219000
]
},
"percentMobileSearches": {
"description": "Percentage of searches for this keyword that originate from mobile devices (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.52
]
},
"percentDesktopSearches": {
"description": "Percentage of searches for this keyword that originate from desktop devices (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.48
]
},
"percentSearchesNotClicked": {
"description": "Percentage of searches where users leave the SERP without clicking any result, often due to sufficient information in featured snippets or direct answers (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.18
]
},
"percentPaidClicks": {
"description": "Percentage of total SERP clicks that go to paid ad results (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.52
]
},
"percentOrganicClicks": {
"description": "Percentage of total SERP clicks that go to organic search results (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.48
]
},
"broadCostPerClick": {
"description": "Average cost-per-click for broad match keyword targeting, representing what advertisers typically pay when their ads are triggered by related keywords.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.73
]
},
"phraseCostPerClick": {
"description": "Average cost-per-click for phrase match keyword targeting, where ads show for searches that include the keyword phrase in the same order.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.67
]
},
"exactCostPerClick": {
"description": "Average cost-per-click for exact match keyword targeting, the most precise and typically highest-performing match type.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.65
]
},
"broadMonthlyClicks": {
"description": "Estimated monthly paid clicks for broad match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "float",
"examples": [
57019.8
]
},
"phraseMonthlyClicks": {
"description": "Estimated monthly paid clicks for phrase match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "float",
"examples": [
38000
]
},
"exactMonthlyClicks": {
"description": "Estimated monthly paid clicks for exact match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "float",
"examples": [
29094.6
]
},
"broadMonthlyCost": {
"description": "Estimated monthly advertising spend for broad match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
41604.9
]
},
"phraseMonthlyCost": {
"description": "Estimated monthly advertising spend for phrase match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
25542
]
},
"exactMonthlyCost": {
"description": "Estimated monthly advertising spend for exact match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
19041.6
]
},
"paidCompetitors": {
"description": "Total number of unique advertisers observed purchasing ads for this keyword over the last 14 months, indicating competitive intensity.",
"type": [
"integer",
"null"
],
"format": "int32",
"examples": [
15
]
},
"distinctCompetitors": {
"description": "List of domain names that have purchased ads for this keyword over the last 14 months.",
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"examples": [
[
"example.com",
"competitor1.com",
"competitor2.com"
]
]
},
"rankingHomepages": {
"description": "Number of domain homepages (root URLs) ranking within the first 100 organic search results for this keyword.",
"type": [
"integer",
"null"
],
"format": "int32",
"examples": [
8
]
},
"serpFeaturesCsv": {
"description": "Comma-separated list of SERP features present for this keyword (e.g., Images, Videos, Maps, Shopping), indicating competition for organic real estate.",
"type": [
"string",
"null"
],
"examples": [
"Images,Maps"
]
},
"serpFirstResult": {
"description": "Domain name of the top-ranking organic result for this keyword, useful for identifying category leaders.",
"type": [
"string",
"null"
],
"examples": [
"example.com"
]
},
"isQuestion": {
"description": "Indicates whether this keyword is phrased as a question (who, what, when, where, why, how).",
"type": "boolean",
"examples": [
false
]
},
"isNotSafeForWork": {
"description": "Indicates whether this keyword is flagged as containing adult or inappropriate content.",
"type": "boolean",
"examples": [
false
]
}
},
"additionalProperties": false,
"description": "Represents a PPC keyword with comprehensive advertising performance metrics including search volume, cost analysis, competitive intelligence, and SERP characteristics for paid search campaign optimization."
},
"readOnly": true
}
},
"additionalProperties": false
},
"PaidSerpApi_GetNewKeywords_GET": {
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Get New PPC Keywords",
"description": "Response wrapper containing PPC keyword research data with detailed advertising performance metrics and pagination metadata for keyword discovery and optimization.",
"type": "object",
"properties": {
"resultCount": {
"description": "Number of results returned",
"type": "integer",
"format": "int32",
"examples": [
100
],
"readOnly": true
},
"totalMatchingResults": {
"description": "Total number of PPC keywords available that match the query criteria, including results not included in the current page.",
"type": "integer",
"format": "int64",
"examples": [
75000
],
"readOnly": true
},
"results": {
"description": "Array of PPC keywords with comprehensive advertising performance metrics including search volume, cost data, and competitive intelligence insights.",
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"keyword": {
"description": "The keyword that shows high performance or profitability for successful competitors in paid search advertising.",
"type": [
"string",
"null"
],
"examples": [
"running shoes"
]
},
"searchVolume": {
"description": "Estimated monthly search volume for this keyword based on Google search data across the selected country/region, blended from multiple sources for accuracy.",
"type": [
"integer",
"null"
],
"format": "int64",
"examples": [
266000
]
},
"liveSearchVolume": {
"description": "Adjusted search volume based on recent trends and real-time data, providing a more current estimate than historical averages.",
"type": [
"integer",
"null"
],
"format": "int64",
"examples": [
82000
]
},
"rankingDifficulty": {
"description": "SEO difficulty score (0-100) indicating how challenging it would be to rank organically for this keyword, with 100 being most difficult.",
"type": [
"integer",
"null"
],
"format": "int32",
"examples": [
98
]
},
"totalMonthlyClicks": {
"description": "Total estimated monthly clicks (both organic and paid) generated from search results for this keyword.",
"type": [
"integer",
"null"
],
"format": "int64",
"examples": [
219000
]
},
"percentMobileSearches": {
"description": "Percentage of searches for this keyword that originate from mobile devices (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.52
]
},
"percentDesktopSearches": {
"description": "Percentage of searches for this keyword that originate from desktop devices (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.48
]
},
"percentSearchesNotClicked": {
"description": "Percentage of searches where users leave the SERP without clicking any result, often due to sufficient information in featured snippets or direct answers (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.18
]
},
"percentPaidClicks": {
"description": "Percentage of total SERP clicks that go to paid ad results (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.52
]
},
"percentOrganicClicks": {
"description": "Percentage of total SERP clicks that go to organic search results (0.0-1.0).",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.48
]
},
"broadCostPerClick": {
"description": "Average cost-per-click for broad match keyword targeting, representing what advertisers typically pay when their ads are triggered by related keywords.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.73
]
},
"phraseCostPerClick": {
"description": "Average cost-per-click for phrase match keyword targeting, where ads show for searches that include the keyword phrase in the same order.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.67
]
},
"exactCostPerClick": {
"description": "Average cost-per-click for exact match keyword targeting, the most precise and typically highest-performing match type.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
0.65
]
},
"broadMonthlyClicks": {
"description": "Estimated monthly paid clicks for broad match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "float",
"examples": [
57019.8
]
},
"phraseMonthlyClicks": {
"description": "Estimated monthly paid clicks for phrase match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "float",
"examples": [
38000
]
},
"exactMonthlyClicks": {
"description": "Estimated monthly paid clicks for exact match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "float",
"examples": [
29094.6
]
},
"broadMonthlyCost": {
"description": "Estimated monthly advertising spend for broad match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
41604.9
]
},
"phraseMonthlyCost": {
"description": "Estimated monthly advertising spend for phrase match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
25542
]
},
"exactMonthlyCost": {
"description": "Estimated monthly advertising spend for exact match targeting of this keyword.",
"type": [
"number",
"null"
],
"format": "double",
"examples": [
19041.6
]
},
"paidCompetitors": {
"description": "Total number of unique advertisers observed purchasing ads for this keyword over the last 14 months, indicating competitive intensity.",
"type": [
"integer",
"null"
],
"format": "int32",
"examples": [
15
]
},
"distinctCompetitors": {
"description": "List of domain names that have purchased ads for this keyword over the last 14 months.",
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"examples": [
[
"example.com",
"competitor1.com",
"competitor2.com"
]
]
},
"rankingHomepages": {
"description": "Number of domain homepages (root URLs) ranking within the first 100 organic search results for this keyword.",
"type": [
"integer",
"null"
],
"format": "int32",
"examples": [
8
]
},
"serpFeaturesCsv": {
"description": "Comma-separated list of SERP features present for this keyword (e.g., Images, Videos, Maps, Shopping), indicating competition for organic real estate.",
"type": [
"string",
"null"
],
"examples": [
"Images,Maps"
]
},
"serpFirstResult": {
"description": "Domain name of the top-ranking organic result for this keyword, useful for identifying category leaders.",
"type": [
"string",
"null"
],
"examples": [
"example.com"
]
},
"isQuestion": {
"description": "Indicates whether this keyword is phrased as a question (who, what, when, where, why, how).",
"type": "boolean",
"examples": [
false
]
},
"isNotSafeForWork": {
"description": "Indicates whether this keyword is flagged as containing adult or inappropriate content.",
"type": "boolean",
"examples": [
false
]
}
},
"additionalProperties": false,
"description": "Represents a PPC keyword with comprehensive advertising performance metrics including search volume, cost analysis, competitive intelligence, and SERP characteristics for paid search campaign optimization."
},
"readOnly": true
}
},
"additionalProperties": false
}
}
}