Give your AI agents access to Stats NZ Datafinder.
Equipping your AI agents with the Stats NZ Datafinder integration enables them to perform precise geographic analysis and retrieve official New Zealand census data directly within your workflows.
- Target location-based insights: extract regional data by querying specific coordinates, boundaries, or custom polygon shapes.
- Simplify census data retrieval: locate and decipher complex demographic columns and codebooks without manual catalog searches.
- Accelerate spatial research: identify relevant geographic layers quickly using streamlined search functions.
Key geographic analysis features
This integration connects your workflows directly to official Stats NZ geographic and census databases. Instead of manually downloading large geospatial datasets, agents can programmatically search public vector layers to find the exact datasets required for your project.
Access precise spatial data
Agents can query layers using geometry, such as bounding boxes or polygons, to analyze demographic trends within exact regional boundaries. The integration filters out unnecessary national noise, delivering compact records that keep operations fast. Agents can also retrieve citation-ready metadata, field descriptions, and catalog links to ensure all retrieved information is verified, formatted correctly, and professionally sourced.
Learn More
Use Case Scenarios
Regional Economic Analysis and Planning — Urban planners and economic development teams need to analyze demographic and economic data within specific geographic boundaries. This integration queries Stats NZ Datafinder layers by polygon geometry, allowing you to extract population, employment, income, and business statistics for defined regions. You get area-weighted overlap calculations automatically, so data accurately reflects the geographic scope you need—whether analyzing a city district, electoral area, or custom boundary.
Census Data Research with Spatial Filtering — Researchers investigating social patterns, housing trends, or health outcomes can isolate census variables by location and attribute criteria. The integration returns only the fields you specify, eliminating unnecessary coded columns and keeping results lean. Combined with point-based queries for neighborhood-level analysis or bounding box searches for broader regions, this streamlines the research workflow and reduces data processing time.
Environmental and Infrastructure Assessment — Environmental consultants and infrastructure planners use geographic queries to cross-reference environmental data with land use, population density, or service boundaries. By combining polygon geometry scopes with attribute filters, you can identify which features fall within your area of interest and meet specific criteria—supporting site selection, impact assessment, and compliance reporting.
Automated Layer Discovery and Integration — Data teams building analytical dashboards or automated reporting systems need to identify relevant datasets without manual catalogue browsing. The search_layers action lets your workflow discover available vector layers by title and publication date, then fetch full metadata including field lists, codebooks, and citation information—enabling you to programmatically select and integrate the right data source.
Cross-Boundary Comparative Analysis — Analysts comparing statistics across multiple geographic units—suburbs, territorial authorities, or statistical areas—can query layers with different geometries and consolidate results. This supports benchmarking, identifying disparities, and supporting evidence-based policy or investment decisions.
Applications
Local Government and Regional Councils — Planning departments, policy teams, and community development groups use geographic data queries to support long-term planning, service delivery analysis, and community engagement. Automating layer discovery and querying reduces manual data requests and accelerates decision-making.
Academic Research and Universities — Geography, urban studies, economics, and social science researchers rely on authoritative New Zealand statistical data. This integration provides programmatic access to verified datasets with proper citations, supporting reproducible research and reducing data preparation overhead.
Urban Planning and Development Consulting — Consultants analyzing feasibility, demographics, and environmental factors for development projects need rapid access to geospatially relevant statistics. Automated queries by project boundaries enable faster turnaround and more sophisticated multi-variable analysis.
Non-Profit and Community Organizations — NGOs focused on social services, housing, health, or environmental advocacy use geographic data to identify need areas, allocate resources, and build evidence for advocacy. Query-by-geometry capabilities make it easy to analyze data relevant to specific communities they serve.
Business Intelligence and Market Research — Market researchers and business strategists analyzing market opportunities, site selection, or demographic targeting benefit from direct access to authoritative New Zealand demographic and economic data, integrated seamlessly into analytical workflows.
Frequently Asked Questions
What is the Stats NZ Datafinder integration used for?
This integration allows you to search, explore, and query geographic and census data layers provided by Stats NZ. You can search for public vector layers, retrieve detailed metadata (including field lists and codebooks), and query specific regions using geographic boundaries or attributes.
Can I perform a query for the entire country of New Zealand at once?
No, unscoped national scans are rejected to ensure optimal performance. All queries must be scoped to a specific geographic area using a Point, a bounding box (bbox), or a Polygon/MultiPolygon (which supports area-weighted overlap analysis), or narrowed down using attribute filters.
Why are some census variables (like VAR_* columns) missing from my query results?
By default, Census coded columns (prefixed with 'VAR_') are omitted to keep data payloads compact. If you need these fields in your analysis, you must explicitly specify them in the 'fields' parameter or set the 'include_coded_fields' option to true in your query.
Are geographic boundary shapes (geometry) included in the query results?
To ensure fast response times, geometry data is omitted by default. If your analysis or mapping tool requires the actual geographic shapes, you can include them by setting the 'include_geometry' parameter to true in your query.