// PUBLIC_API
Free smart city data API
Live smart city rankings, evidence-linked assessment scores and data-coverage maps for 213+ cities — free, no API key, CC BY 4.0. Built for developers, data journalists and AI agents.
Base URL https://citymirror.io/api · JSON · CORS enabled · attribution: link to datacorridor.io
/api/assessments?framework=smart-citiesSmart city rankings
The full ranking: every assessed city with its smart score, evidence coverage and criteria counts, plus the framework's axes and categories. Frameworks: smart-cities (DC20) and smart-cities-iso (ISO-aligned).
curl "https://citymirror.io/api/assessments?framework=smart-cities"{ "frameworkId": "smart-cities", "count": 213, "ranking": [ { "scopeId": "singapore", "name": "Singapore", "smartnessPct": 98.3, "evidencePct": 100, "present": 79, "total": 82 }, … ] }/api/assessments/scope?scopeId={id}&framework=smart-citiesPer-city assessment
One city's full assessment: score, and every criterion with its status (present / partial / absent), the written finding, confidence and source URLs. scopeId examples: uk.manchester, singapore, new-york-city.
curl "https://citymirror.io/api/assessments/scope?scopeId=uk.manchester&framework=smart-cities"{ "name": "Manchester", "score": { "smartnessPct": 77.6, "present": 59, "total": 82 }, "categories": [ { "name": "Open Data by Default", "criteria": [ { "name": "Official open data portal", "status": "present", "finding": "…", "sources": [{ "url": "…" }] } ] } ] }/api/coverage/query?pattern={scope}Data coverage for a scope
What data a city/region/country publishes across transport, energy, water, environment, connectivity and housing — and what's missing, stale or siloed.
curl "https://citymirror.io/api/coverage/query?pattern=uk.manchester"/api/coverage/recentRecently updated coverage
The most recently re-grounded coverage entries — useful for change feeds.
curl "https://citymirror.io/api/coverage/recent"/api/search?q={query}Intent search
Natural-language search over cities, datasets and assessments — built for agents. Also available as /api/interpret for structured intent parsing.
curl "https://citymirror.io/api/search?q=manchester%20air%20quality"/api/resources?scopeId={id}City data repositories & news
Official data portals, repositories and recent local/national news for a city.
curl "https://citymirror.io/api/resources?scopeId=uk.manchester"Usage, licence & fair use
- Data is licensed CC BY 4.0: free for articles, dashboards, research and products — credit "Data Corridor" with a link to datacorridor.io.
- No key needed. Please cache responses and keep request rates reasonable; heavy or commercial-scale users should get in touch via datacorridor.io.
- Methodology: scores come from the DC20 smart city framework — every finding carries its source URL, so results are independently checkable.
- AI agents: machine-readable site overview at /llms.txt.