SpyFu · Schema
SpyFu Domain Stats API Schemas
JSON Schema definitions for SpyFu Domain Stats API API responses
SEOPPCCompetitive IntelligenceKeyword ResearchAd HistoryBacklinksDomain AnalyticsSERP
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "SpyFu Domain Stats API Schemas",
"description": "JSON Schema definitions for SpyFu Domain Stats API API responses",
"definitions": {
"DomainStatsApi_GetAllDomainStats_GET": {
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Get All Domain Stats",
"description": "Response wrapper containing comprehensive domain performance statistics across multiple time periods with detailed SEO and PPC metrics.",
"type": "object",
"properties": {
"domain": {
"description": "Domain name for which the statistics were collected and analyzed.",
"type": [
"string",
"null"
],
"examples": [
"example.com"
]
},
"results": {
"description": "Array of domain performance statistics organized by time period, including SEO metrics, PPC data, traffic estimates, and competitive strength indicators.",
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"searchMonth": {
"description": "Month when these domain statistics were collected (1-12).",
"type": "integer",
"format": "int32",
"examples": [
5
]
},
"searchYear": {
"description": "Year when these domain statistics were collected.",
"type": "integer",
"format": "int32",
"examples": [
2021
]
},
"averageOrganicRank": {
"description": "Average organic search ranking position across all keywords for this domain during the specified month.",
"type": "number",
"format": "double",
"examples": [
41.08
]
},
"monthlyPaidClicks": {
"description": "Estimated monthly clicks received from paid search advertising across all keywords, calculated based on average ad positions and click-through rates.",
"type": "number",
"format": "double",
"examples": [
61181.88
]
},
"averageAdRank": {
"description": "Average paid search ad position across all advertised keywords during the specified month.",
"type": "number",
"format": "double",
"examples": [
1.03
]
},
"totalOrganicResults": {
"description": "Total number of unique organic keywords where this domain appears in the top 100 search results during the specified month.",
"type": "integer",
"format": "int32",
"examples": [
302731
]
},
"monthlyBudget": {
"description": "Estimated monthly Google Ads spending based on keyword positions, click-through rates, and cost-per-click data across all paid campaigns.",
"type": "number",
"format": "double",
"examples": [
6721.39
]
},
"monthlyOrganicValue": {
"description": "Estimated value of organic search traffic based on keyword rankings and equivalent cost-per-click values, representing the advertising spend equivalent of organic visibility.",
"type": "number",
"format": "double",
"examples": [
384233.16
]
},
"totalAdsPurchased": {
"description": "Total number of unique paid keywords where this domain's ads appeared on the first page of search results, measured over the last 14 data collection periods.",
"type": "integer",
"format": "int32",
"examples": [
599
]
},
"monthlyOrganicClicks": {
"description": "Estimated monthly organic search traffic clicks received from all ranking keywords during the specified month.",
"type": "number",
"format": "double",
"examples": [
290145
]
},
"strength": {
"description": "Domain authority score (0-100) indicating competitive strength and ranking consistency across high-value keywords, with higher scores representing stronger market position.",
"type": "integer",
"format": "int32",
"examples": [
75
]
},
"totalInverseRank": {
"description": "Cumulative ranking score where higher organic positions receive higher point values (position 1 = 100 points, position 2 = 99 points, etc.), summed across all ranking keywords.",
"type": "integer",
"format": "int64",
"examples": [
4971564
]
},
"areStatsNormalized": {
"description": "Indicates whether the statistics have been normalized for consistent comparison across different time periods and data collection methods.",
"type": "boolean",
"examples": [
true
]
}
},
"additionalProperties": false,
"description": "Represents comprehensive domain performance statistics for a specific month, including SEO and PPC metrics, traffic estimates, and competitive strength indicators."
}
},
"resultCount": {
"description": "Number of results returned",
"type": "integer",
"format": "int32",
"examples": [
1
],
"readOnly": true
}
},
"additionalProperties": false
},
"DomainStatsApi_GetLatestDomainStats_GET": {
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Get Latest Domain Stats",
"description": "Response wrapper containing comprehensive domain performance statistics across multiple time periods with detailed SEO and PPC metrics.",
"type": "object",
"properties": {
"domain": {
"description": "Domain name for which the statistics were collected and analyzed.",
"type": [
"string",
"null"
],
"examples": [
"example.com"
]
},
"results": {
"description": "Array of domain performance statistics organized by time period, including SEO metrics, PPC data, traffic estimates, and competitive strength indicators.",
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"searchMonth": {
"description": "Month when these domain statistics were collected (1-12).",
"type": "integer",
"format": "int32",
"examples": [
5
]
},
"searchYear": {
"description": "Year when these domain statistics were collected.",
"type": "integer",
"format": "int32",
"examples": [
2021
]
},
"averageOrganicRank": {
"description": "Average organic search ranking position across all keywords for this domain during the specified month.",
"type": "number",
"format": "double",
"examples": [
41.08
]
},
"monthlyPaidClicks": {
"description": "Estimated monthly clicks received from paid search advertising across all keywords, calculated based on average ad positions and click-through rates.",
"type": "number",
"format": "double",
"examples": [
61181.88
]
},
"averageAdRank": {
"description": "Average paid search ad position across all advertised keywords during the specified month.",
"type": "number",
"format": "double",
"examples": [
1.03
]
},
"totalOrganicResults": {
"description": "Total number of unique organic keywords where this domain appears in the top 100 search results during the specified month.",
"type": "integer",
"format": "int32",
"examples": [
302731
]
},
"monthlyBudget": {
"description": "Estimated monthly Google Ads spending based on keyword positions, click-through rates, and cost-per-click data across all paid campaigns.",
"type": "number",
"format": "double",
"examples": [
6721.39
]
},
"monthlyOrganicValue": {
"description": "Estimated value of organic search traffic based on keyword rankings and equivalent cost-per-click values, representing the advertising spend equivalent of organic visibility.",
"type": "number",
"format": "double",
"examples": [
384233.16
]
},
"totalAdsPurchased": {
"description": "Total number of unique paid keywords where this domain's ads appeared on the first page of search results, measured over the last 14 data collection periods.",
"type": "integer",
"format": "int32",
"examples": [
599
]
},
"monthlyOrganicClicks": {
"description": "Estimated monthly organic search traffic clicks received from all ranking keywords during the specified month.",
"type": "number",
"format": "double",
"examples": [
290145
]
},
"strength": {
"description": "Domain authority score (0-100) indicating competitive strength and ranking consistency across high-value keywords, with higher scores representing stronger market position.",
"type": "integer",
"format": "int32",
"examples": [
75
]
},
"totalInverseRank": {
"description": "Cumulative ranking score where higher organic positions receive higher point values (position 1 = 100 points, position 2 = 99 points, etc.), summed across all ranking keywords.",
"type": "integer",
"format": "int64",
"examples": [
4971564
]
},
"areStatsNormalized": {
"description": "Indicates whether the statistics have been normalized for consistent comparison across different time periods and data collection methods.",
"type": "boolean",
"examples": [
true
]
}
},
"additionalProperties": false,
"description": "Represents comprehensive domain performance statistics for a specific month, including SEO and PPC metrics, traffic estimates, and competitive strength indicators."
}
},
"resultCount": {
"description": "Number of results returned",
"type": "integer",
"format": "int32",
"examples": [
1
],
"readOnly": true
}
},
"additionalProperties": false
},
"DomainStatsApi_GetDomainStatsForExactDate_GET": {
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Get Domain Stats For Exact Date",
"description": "Response wrapper containing comprehensive domain performance statistics across multiple time periods with detailed SEO and PPC metrics.",
"type": "object",
"properties": {
"domain": {
"description": "Domain name for which the statistics were collected and analyzed.",
"type": [
"string",
"null"
],
"examples": [
"example.com"
]
},
"results": {
"description": "Array of domain performance statistics organized by time period, including SEO metrics, PPC data, traffic estimates, and competitive strength indicators.",
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"searchMonth": {
"description": "Month when these domain statistics were collected (1-12).",
"type": "integer",
"format": "int32",
"examples": [
5
]
},
"searchYear": {
"description": "Year when these domain statistics were collected.",
"type": "integer",
"format": "int32",
"examples": [
2021
]
},
"averageOrganicRank": {
"description": "Average organic search ranking position across all keywords for this domain during the specified month.",
"type": "number",
"format": "double",
"examples": [
41.08
]
},
"monthlyPaidClicks": {
"description": "Estimated monthly clicks received from paid search advertising across all keywords, calculated based on average ad positions and click-through rates.",
"type": "number",
"format": "double",
"examples": [
61181.88
]
},
"averageAdRank": {
"description": "Average paid search ad position across all advertised keywords during the specified month.",
"type": "number",
"format": "double",
"examples": [
1.03
]
},
"totalOrganicResults": {
"description": "Total number of unique organic keywords where this domain appears in the top 100 search results during the specified month.",
"type": "integer",
"format": "int32",
"examples": [
302731
]
},
"monthlyBudget": {
"description": "Estimated monthly Google Ads spending based on keyword positions, click-through rates, and cost-per-click data across all paid campaigns.",
"type": "number",
"format": "double",
"examples": [
6721.39
]
},
"monthlyOrganicValue": {
"description": "Estimated value of organic search traffic based on keyword rankings and equivalent cost-per-click values, representing the advertising spend equivalent of organic visibility.",
"type": "number",
"format": "double",
"examples": [
384233.16
]
},
"totalAdsPurchased": {
"description": "Total number of unique paid keywords where this domain's ads appeared on the first page of search results, measured over the last 14 data collection periods.",
"type": "integer",
"format": "int32",
"examples": [
599
]
},
"monthlyOrganicClicks": {
"description": "Estimated monthly organic search traffic clicks received from all ranking keywords during the specified month.",
"type": "number",
"format": "double",
"examples": [
290145
]
},
"strength": {
"description": "Domain authority score (0-100) indicating competitive strength and ranking consistency across high-value keywords, with higher scores representing stronger market position.",
"type": "integer",
"format": "int32",
"examples": [
75
]
},
"totalInverseRank": {
"description": "Cumulative ranking score where higher organic positions receive higher point values (position 1 = 100 points, position 2 = 99 points, etc.), summed across all ranking keywords.",
"type": "integer",
"format": "int64",
"examples": [
4971564
]
},
"areStatsNormalized": {
"description": "Indicates whether the statistics have been normalized for consistent comparison across different time periods and data collection methods.",
"type": "boolean",
"examples": [
true
]
}
},
"additionalProperties": false,
"description": "Represents comprehensive domain performance statistics for a specific month, including SEO and PPC metrics, traffic estimates, and competitive strength indicators."
}
},
"resultCount": {
"description": "Number of results returned",
"type": "integer",
"format": "int32",
"examples": [
1
],
"readOnly": true
}
},
"additionalProperties": false
},
"DomainStatsApi_GetActiveDatesForDomain_GET": {
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Get Active Dates For Domain",
"description": "Response wrapper containing a list of available search dates for which domain statistics data is available, used for historical analysis and date-specific queries.",
"type": "object",
"properties": {
"resultCount": {
"description": "Number of results returned",
"type": "integer",
"format": "int32",
"examples": [
100
],
"readOnly": true
},
"results": {
"description": "Array of available search dates for which domain performance statistics have been collected and can be queried.",
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"dateString": {
"type": [
"string",
"null"
]
},
"month": {
"type": "integer",
"format": "int32",
"readOnly": true
},
"year": {
"type": "integer",
"format": "int32",
"readOnly": true
}
},
"additionalProperties": false
},
"readOnly": true
}
},
"additionalProperties": false
},
"DomainStatsApi_GetBulkDomainStats_GET": {
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Bulk Domain Statistics (Snapshot or History)",
"description": "Returns SEO and PPC metrics for multiple domains in one request. Suitable for batch enrichment, benchmarking, and portfolio monitoring.",
"type": "object",
"properties": {
"resultCount": {
"description": "Number of results returned",
"type": "integer",
"format": "int32",
"examples": [
1
],
"readOnly": true
},
"totalMatchingResults": {
"description": "The total number of results available that matches the query including\r\nitems that might not be included in the returned results/page.",
"type": [
"integer",
"null"
],
"format": "int64",
"readOnly": true
},
"results": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"domain": {
"description": "Searched domain",
"type": [
"string",
"null"
],
"examples": [
"domain.com"
]
},
"results": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"searchMonth": {
"description": "Month when these domain statistics were collected (1-12).",
"type": "integer",
"format": "int32",
"examples": [
5
]
},
"searchYear": {
"description": "Year when these domain statistics were collected.",
"type": "integer",
"format": "int32",
"examples": [
2021
]
},
"averageOrganicRank": {
"description": "Average organic search ranking position across all keywords for this domain during the specified month.",
"type": "number",
"format": "double",
"examples": [
41.08
]
},
"monthlyPaidClicks": {
"description": "Estimated monthly clicks received from paid search advertising across all keywords, calculated based on average ad positions and click-through rates.",
"type": "number",
"format": "double",
"examples": [
61181.88
]
},
"averageAdRank": {
"description": "Average paid search ad position across all advertised keywords during the specified month.",
"type": "number",
"format": "double",
"examples": [
1.03
]
},
"totalOrganicResults": {
"description": "Total number of unique organic keywords where this domain appears in the top 100 search results during the specified month.",
"type": "integer",
"format": "int32",
"examples": [
302731
]
},
"monthlyBudget": {
"description": "Estimated monthly Google Ads spending based on keyword positions, click-through rates, and cost-per-click data across all paid campaigns.",
"type": "number",
"format": "double",
"examples": [
6721.39
]
},
"monthlyOrganicValue": {
"description": "Estimated value of organic search traffic based on keyword rankings and equivalent cost-per-click values, representing the advertising spend equivalent of organic visibility.",
"type": "number",
"format": "double",
"examples": [
384233.16
]
},
"totalAdsPurchased": {
"description": "Total number of unique paid keywords where this domain's ads appeared on the first page of search results, measured over the last 14 data collection periods.",
"type": "integer",
"format": "int32",
"examples": [
599
]
},
"monthlyOrganicClicks": {
"description": "Estimated monthly organic search traffic clicks received from all ranking keywords during the specified month.",
"type": "number",
"format": "double",
"examples": [
290145
]
},
"strength": {
"description": "Domain authority score (0-100) indicating competitive strength and ranking consistency across high-value keywords, with higher scores representing stronger market position.",
"type": "integer",
"format": "int32",
"examples": [
75
]
},
"totalInverseRank": {
"description": "Cumulative ranking score where higher organic positions receive higher point values (position 1 = 100 points, position 2 = 99 points, etc.), summed across all ranking keywords.",
"type": "integer",
"format": "int64",
"examples": [
4971564
]
},
"areStatsNormalized": {
"description": "Indicates whether the statistics have been normalized for consistent comparison across different time periods and data collection methods.",
"type": "boolean",
"examples": [
true
]
}
},
"additionalProperties": false,
"description": "Represents comprehensive domain performance statistics for a specific month, including SEO and PPC metrics, traffic estimates, and competitive strength indicators."
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"DomainStatsApi_GetMatchingDomains_GET": {
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Find Domains by Pattern and Metrics",
"description": "Discovers domains matching wildcard patterns and performance criteria for lead generation and competitive prospecting. Use wildcards like `*car*` to find automotive domains or filter by traffic, budge",
"type": "object",
"properties": {
"resultCount": {
"description": "Number of results returned",
"type": "integer",
"format": "int32",
"examples": [
1
],
"readOnly": true
},
"totalMatchingResults": {
"description": "The total number of results available that matches the query including\r\nitems that might not be included in the returned results/page.",
"type": [
"integer",
"null"
],
"format": "int64",
"readOnly": true
},
"results": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"domain": {
"description": "Searched domain",
"type": [
"string",
"null"
],
"examples": [
"domain.com"
]
},
"results": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"searchMonth": {
"description": "Month when these domain statistics were collected (1-12).",
"type": "integer",
"format": "int32",
"examples": [
5
]
},
"searchYear": {
"description": "Year when these domain statistics were collected.",
"type": "integer",
"format": "int32",
"examples": [
2021
]
},
"averageOrganicRank": {
"description": "Average organic search ranking position across all keywords for this domain during the specified month.",
"type": "number",
"format": "double",
"examples": [
41.08
]
},
"monthlyPaidClicks": {
"description": "Estimated monthly clicks received from paid search advertising across all keywords, calculated based on average ad positions and click-through rates.",
"type": "number",
"format": "double",
"examples": [
61181.88
]
},
"averageAdRank": {
"description": "Average paid search ad position across all advertised keywords during the specified month.",
"type": "number",
"format": "double",
"examples": [
1.03
]
},
"totalOrganicResults": {
"description": "Total number of unique organic keywords where this domain appears in the top 100 search results during the specified month.",
"type": "integer",
"format": "int32",
"examples": [
302731
]
},
"monthlyBudget": {
"description": "Estimated monthly Google Ads spending based on keyword positions, click-through rates, and cost-per-click data across all paid campaigns.",
"type": "number",
"format": "double",
"examples": [
6721.39
]
},
"monthlyOrganicValue": {
"description": "Estimated value of organic search traffic based on keyword rankings and equivalent cost-per-click values, representing the advertising spend equivalent of organic visibility.",
"type": "number",
"format": "double",
"examples": [
384233.16
]
},
"totalAdsPurchased": {
"description": "Total number of unique paid keywords where this domain's ads appeared on the first page of search results, measured over the last 14 data collection periods.",
"type": "integer",
"format": "int32",
"examples": [
599
]
},
"monthlyOrganicClicks": {
"description": "Estimated monthly organic search traffic clicks received from all ranking keywords during the specified month.",
"type": "number",
"format":
# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/spyfu/refs/heads/main/json-schema/spyfu-domain-stats-schema.json