Benchmarks API
TL;DR
The Benchmarks API returns aggregate AI readiness statistics broken down by industry, CMS platform, country, or language. Use it to compare any site against its peer group.
Last updated: 2026-03-09
Endpoint Overview#
The Benchmarks API provides aggregate statistics from the AgentReady™ scan database. You can retrieve average scores, sub-score breakdowns, and grade distributions for any supported dimension — industry, CMS, country, or language.
This is the same data that powers the Benchmarks page in the AgentReady™ dashboard. Use it to build comparison reports, competitive analyses, or client-facing dashboards.
Benchmarks Endpoint
GET /api/benchmarks?view=industryhttp
Query Parameters#
The benchmarks endpoint supports the following query parameters to control what data is returned.
view(string, required) — The dimension to aggregate by. Values:industry,cms,country,language.industry(string, optional) — Filter results to a specific industry. Only applicable whenviewis notindustry.limit(number, optional) — Maximum number of rows to return. Default: 20. Maximum: 100.sort(string, optional) — Sort field. Values:avgScore(default),count,name.
Response Format#
The response includes an array of benchmark rows, each containing the dimension value, average scores for all eight factors, count of scans in that group, and grade distribution percentages.
Response Example (industry view)
{
"view": "industry",
"data": [
{
"name": "saas",
"count": 142,
"avgScore": 58.3,
"avgSchema": 52.1,
"avgContent": 65.4,
"avgBotAccess": 71.2,
"avgTopicClarity": 48.9,
"avgProtocols": 35.6,
"avgSpeed": 72.8,
"avgAuthority": 55.1,
"avgCrawlEfficiency": 61.3
}
]
}json
Common Use Cases#
The Benchmarks API is particularly useful for agencies and consultants. Compare a client's scores against their industry average to show where they lead or lag. Build competitive intelligence reports by filtering to a specific industry and CMS combination.
You can also use benchmark data to set realistic improvement targets. If the industry average for Schema Markup is 45, and your client scores 30, you know there is clear room for improvement. If they already score 70, they are well above average and can focus on other factors.
Related Pages
Frequently Asked Questions
How often is the benchmark data updated?
Benchmark data is recalculated daily based on the full scan database. As new scans are added, the averages update automatically. Historical benchmark data is not currently available through the API.
Can I filter benchmarks by multiple dimensions?
Currently, you can aggregate by one dimension at a time (industry, CMS, country, or language) and optionally filter by industry. Cross-dimensional filtering (e.g., WordPress sites in the healthcare industry) is planned for a future release.
Was this page helpful?