What it returns
Census and structural statistics by electoral district, so demographics join straight to election results.
- UK (
UK): all 650 Westminster constituencies (July 2024 boundaries). England and Wales: ONS Census 2021 topic summaries from Nomis, summed from output areas with the ONS best-fit lookup, 17 tables. Scotland (57 seats): Scotland's Census 2022 output-area tables from National Records of Scotland, summed with NRS's output area to constituency lookup, 23 tables (UV...ids). Northern Ireland (18 seats): NISRA Census 2021 Flexible Table Builder counts by 2024 constituency, 23 tables (ids are NISRA variable names, e.g.RELIGION_BELONG_TO_OR_BROUGHT_UP_IN_DVO). - Germany (
DE): 299 Bundestag constituencies (2025). Die Bundeswahlleiterin, Strukturdaten. 49 tables. - Australia (
AU): 151 Commonwealth Electoral Divisions (2021 boundaries, used at the 2022 federal election). ABS Census 2021 via the ABS Data API. 11 tables. - Canada (
CA): 338 federal electoral districts (2013 Representation Order, used at the 2015, 2019 and 2021 elections). Statistics Canada Census 2021 data tables via the WDS. 6 tables. - New Zealand (
NZ): the 2025 electorates used at the 2026 general election, 64 general (GE001...) and 7 Māori (ME001...). Stats NZ 2023 Census totals by topic, summed from SA1s (each SA1 goes to the electorate holding its centroid). 10 tables.
England and Wales tables: usual residents, age (five-year bands), sex, country of birth, ethnic group, religion, tenure, NS-SeC (social class), economic activity, highest qualification, household deprivation, household size, English proficiency, general health, car or van availability, distance and method of travel to work.
Scotland tables: age and sex, marital status, ethnic group, national identity, country of birth, religion, passports, Gaelic, main language, general health, disability, accommodation type, tenure, cars, household size, qualifications, economic activity, occupation, NS-SeC, travel to work (method, distance), year of arrival, armed forces veterans.
Northern Ireland tables: sex, age, religion, religion or religion brought up in, national identity, passports, ethnic group, country of birth, Irish and Ulster-Scots ability, marital status, general health, disability, qualifications, economic activity, NS-SeC, social grade, occupation, industry, tenure, cars, accommodation type, travel to work.
Australia: selected person characteristics, medians and averages (age, incomes, rent, mortgage, household size), age by sex, religion, personal income, dwelling structure, tenure and landlord, labour force, qualifications, occupation; categories join the table's dimensions with | (e.g. Persons | Total persons).
Canada: population and dwellings, age (single years, average, median), gender, marital status, mother tongue, knowledge of official languages, language spoken at home, visible minority, immigrant status and period, citizenship. Each table's breakdowns are given with the other dimensions at their totals.
New Zealand: usually resident population, age (five-year and life-cycle groups), gender, ethnicity (total responses, so shares add to more than 100), highest qualification, personal income, work and labour force status, household tenure and household income. Māori electorates cover everyone living in them, not only voters on the Māori roll; general and Māori electorates overlap, so each person counts once in each set.
Germany: population, foreign nationals, density, natural change and migration, age groups, land use, housing, cars (incl. electric), businesses, school leavers, employment by sector, unemployment, income and GDP per head, social benefits.
Request
POST https://api.pushbuild.com/census-by-electoral-district/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
countries | list of strings | UK (all 650 July 2024 Westminster constituencies), DE (Bundestag constituencies 2025) AU (Commonwealth Electoral Divisions, 2021 boundaries), CA (federal electoral districts, 2013 Representation Order) or NZ (2025 general and Māori electorates). |
districts | list of strings | Constituency codes (E14001101, 001) or part of a name (Bishop Auckland, Flensburg). |
tables | list of strings | Table ids (TS021, DE09) or part of a table name (Ethnic group, Alter). Use listTables to see them. |
categories | list of strings | Part of a category name, e.g. Owned, Degree, unter 18. |
listTables | boolean | Return the available tables per country instead of data. Default: false. |
offset | integer | Skip this many rows (for paging). Default: 0. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/census-by-electoral-district/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"maxItems": 20}'
Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 records. No charge for errors or empty searches.
Use it from Claude, ChatGPT or Cursor
This API is also an MCP server: https://api.pushbuild.com/mcp/census-by-electoral-district. Add it to any assistant that supports remote MCP servers, with your key in the X-API-Key header. Same prices. Setup for each app.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.comWant this data inside your own app or CRM? API integrations and data sync