Preview tool · Open data

Search NZ government datasets

Preview: Find New Zealand government dataset listings for market and regional research.

Start building free Connect your client

Published tool ID

nz_dataset_search

Preview: Find New Zealand government dataset listings for market and regional research.

ServerNew Zealand

Information categoryPublic government dataset listings

Credit behavior2 credits; 1 with your own key

AccessWorkspace permissions

Inputs and outputs

Published input schema

Use the discovered runtime schema for the workspace you are connected to.

Public catalog

nz_dataset_search input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "limit": {
      "default": 5,
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "detail": {
      "default": "standard",
      "type": "string",
      "enum": [
        "summary",
        "standard",
        "full"
      ]
    },
    "fields": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$"
      }
    }
  },
  "required": [
    "query",
    "limit",
    "detail"
  ],
  "additionalProperties": false
}

Published output shape

Tool results return structured data or a stable error object.

Shared Aroai tool output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "summary": {
          "type": "string"
        },
        "data": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "executionId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "creditsCharged": {
          "type": "number",
          "minimum": 0
        }
      },
      "required": [
        "summary",
        "data",
        "creditsCharged"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "error"
      ],
      "additionalProperties": false
    }
  ]
}

Source and usage notes

Understand the result boundary

Costs 2 credits per search, or 1 with a supported workspace search key.
Returns up to ten indexed dataset listings and links, not data files. Very recent listings may be missing.
Check dataset coverage, dates and reuse terms before using the underlying data.
Direct NZ dataset detail retrieval is Coming soon.

Explore AU/NZ toolkits

Use this capability

Build on your next business question.

Explore related tools or connect your AI client to get started.

Explore tools Client setup

Local intelligence. Ready to build.

Put your AI to work.

Create a free workspace and bring local business context into your AI tools.

Start building free Explore tools