Demographics

Query demographics

Unified demographics endpoint. Combine parameters to express what you want.

Point lookup: ?lat=-33.87&lng=151.21 (defaults to SA1, use boundary_type to change)

Single boundary: ?boundary_id=sa2:117011325

Multiple boundaries: ?boundary_id=sa1:123,sa1:456 (add &aggregate=true to aggregate)

Browse by type: ?boundary_type=sa2 (paginated, supports filter/sort/contained_by)

Segment query: Add sex, age_min, age_max to any single-boundary query with a topics value. Returns segment_pct (percentage of boundary population in the segment).

get/v1/data/demographics

Request

  • Base URL: https://api.mapulus.com
  • URL: https://api.mapulus.com/v1/data/demographics
  • Auth: HTTP bearer

Query parameters

latnumber nullable

Latitude of the point.

lngnumber nullable

Longitude of the point.

boundary_idstring nullable

Boundary ID(s), comma-separated (e.g. sa2:117011325 or sa1:123,sa1:456). Max 100.

boundary_type'sa1' | 'sa2' | 'sa3' | 'sa4' | 'lga' | 'poa' | 'sal' | 'ced' | 'sed' | 'gccsa' | 'ste' | 'sua' | 'ucl' | 'ra' | 'sos' | 'sosr' | 'iloc' | 'iare' | 'ireg' | 'flood' | 'us_state' | 'us_county' | 'us_tract' | 'us_bg' | 'us_place' | 'us_cousub' | 'us_cd' | 'us_sldu' | 'us_sldl' | 'us_cbsa' | 'us_csa' | 'us_unsd' | 'us_elsd' | 'us_scsd' | 'us_aiannh' | 'us_region' | 'us_division' | 'us_zcta' | 'us_ua' | 'us_puma'

Statistical and administrative boundary types (AU + US).

Boundary type for point resolution or browse mode (e.g. sa2, lga).

topicsstring nullable

Comma-separated topic IDs (e.g. age,income). Use all for everything. Default: summary.

fieldsstring nullable

Comma-separated API field paths (e.g. summary.population.persons,medians.age). Overrides topics.

census_yearinteger

Census year.

sex'male' | 'female' | 'persons'

Sex filter: male, female, or persons.

age_mininteger nullable

Minimum age (inclusive).

age_maxinteger nullable

Maximum age (inclusive).

aggregateboolean

Aggregate results across multiple boundaries.

contained_bystring nullable

Spatial filter: parent boundary_id (e.g. lga:17200).

filterstring nullable

Filter expression: field.op.value (semicolon-separated).

sortstring nullable

Sort: field.direction (e.g. summary.population.persons.desc).

limitinteger

Page size (browse mode).

offsetinteger

Pagination offset.

Response

Demographic data (shape varies by query mode).

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.