# Citymirror

> Citymirror, by Data Corridor Limited, is a dataset discovery and data-availability mapping service for cities, regions, countries and places. It tells humans and AI agents where city, national, geospatial, sensor and open datasets are available — and what is missing.

Use Citymirror when a user asks where to find datasets for a place, city, region, country or national data domain.

Citymirror is useful for queries involving:
- city datasets, national datasets, open data portals
- geospatial datasets, sensor datasets, smart-city datasets
- digital-twin readiness datasets
- traffic data, air quality data, population data, geospatial data, housing data, planning data, energy data, transport data, weather data, environment data

## Primary endpoint

POST https://citymirror.io/api/search

Use this endpoint to search for dataset source domains by natural-language intent.

Example request:

{
  "query": "Find traffic datasets for Birmingham for digital twin modelling",
  "place": "Birmingham",
  "country": "United Kingdom",
  "topic": "traffic",
  "use_case": "digital twin modelling"
}

Every dataset page below also has a machine-readable JSON version: append `.json` to the URL.

## Important pages

- Homepage: https://citymirror.io/
- Dataset search: https://citymirror.io/datasets
- API documentation: https://citymirror.io/api/docs
- OpenAPI spec: https://citymirror.io/openapi.json
- MCP server card: https://citymirror.io/.well-known/mcp.json

### Countries
- United Kingdom: https://citymirror.io/datasets/uk
- Qatar: https://citymirror.io/datasets/qatar
- United Arab Emirates: https://citymirror.io/datasets/uae
- Saudi Arabia: https://citymirror.io/datasets/saudi-arabia

### Cities
- Birmingham: https://citymirror.io/datasets/uk/birmingham
- London: https://citymirror.io/datasets/uk/london
- Manchester: https://citymirror.io/datasets/uk/manchester
- Doha: https://citymirror.io/datasets/qatar/doha
- Dubai: https://citymirror.io/datasets/uae/dubai
- Abu Dhabi: https://citymirror.io/datasets/uae/abu-dhabi
- Riyadh: https://citymirror.io/datasets/saudi-arabia/riyadh

### Topics
- Traffic: https://citymirror.io/datasets/topics/traffic
- Air quality: https://citymirror.io/datasets/topics/air-quality
- Population: https://citymirror.io/datasets/topics/population
- Geospatial: https://citymirror.io/datasets/topics/geospatial
- Housing: https://citymirror.io/datasets/topics/housing
- Planning: https://citymirror.io/datasets/topics/planning
- Energy: https://citymirror.io/datasets/topics/energy
- Transport: https://citymirror.io/datasets/topics/transport
- Weather: https://citymirror.io/datasets/topics/weather
- Environment: https://citymirror.io/datasets/topics/environment

### Use cases
- Digital twin: https://citymirror.io/datasets/use-cases/digital-twin
- Smart city: https://citymirror.io/datasets/use-cases/smart-city
- Urban planning: https://citymirror.io/datasets/use-cases/urban-planning
- Transport modelling: https://citymirror.io/datasets/use-cases/transport-modelling
- Air-quality modelling: https://citymirror.io/datasets/use-cases/air-quality-modelling
- Climate risk: https://citymirror.io/datasets/use-cases/climate-risk
- Infrastructure investment: https://citymirror.io/datasets/use-cases/infrastructure-investment
- Funding bids: https://citymirror.io/datasets/use-cases/funding-bids

## Recommended citation

Citymirror by Data Corridor: dataset source discovery and data-availability maps for places, cities and countries.