# New Zealand Companies Register Scraper (`scrapers_lat/newzealand-companies-scraper`) Actor
Search the New Zealand companies register and export company records: company number, NZBN, name, status, entity type, incorporation date and registered office address. Export to JSON, CSV or Excel.
- **URL**: https://apify.com/scrapers\_lat/newzealand-companies-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Lead generation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $12.75 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## New Zealand Companies Register Scraper
> Search the New Zealand companies register by name, number or NZBN and get structured company records: company number, NZBN, name, status, entity type, incorporation date and registered office address. Clean structured data for KYB, due diligence and lead lists.
Company profile number, NZBN, status
Type & address entity type, office
JSON / CSV / Excel output formats
**๐ฅ [Input](https://apify.com/scrapers_lat/newzealand-companies-scraper/input-schema) ยท ๐ค [Output](https://apify.com/scrapers_lat/newzealand-companies-scraper/output-schema) ยท ๐ฐ [Pricing](https://apify.com/scrapers_lat/newzealand-companies-scraper/pricing) ยท โถ๏ธ [Examples](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples)**
### What you get
Each record is one registered New Zealand entity, ready for a KYB workflow, a CRM or a spreadsheet:
- **companyNumber**: the official company number
- **nzbn**: the New Zealand Business Number
- **name**: registered company name
- **status**: whether the company is registered, removed or in another state
- **entityType** and **entityTypeLabel**: legal entity type (for example NZ limited company or overseas company)
- **incorporationDate**: date the company was incorporated or registered
- **registeredOffice**: registered office address when published
- **url** and **observedAt**: source link and freshness
### Who is it for
| Use case | Who benefits |
|---|---|
| KYB and onboarding | Compliance teams verifying New Zealand counterparties |
| Due diligence | Analysts checking status, type and incorporation date |
| Lead generation | Sales teams building New Zealand company lists |
| Data enrichment | Builders adding official registry data to their own databases |
### How to use it
1. Enter a **company name keyword, company number or NZBN**, for example `air new zealand`.
2. Set **Max Items** and run.
3. Export as JSON, CSV or Excel, or pull the results through the Apify API.
### Frequently Asked Questions
**What is an NZBN?**
It is the New Zealand Business Number, a globally unique identifier for New Zealand businesses. Each record includes it alongside the company number.
**Can I search by number instead of name?**
Yes. You can enter a company name keyword, a company number or an NZBN and the search returns the matching entities.
**Does it include the registered office?**
Yes. The registered office address is included whenever it is published and not suppressed.
**How fresh is the data?**
Every record is read live at run time, so it reflects the current registry entry at the moment of the run (see observedAt).
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [Air New Zealand company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-air-new-zealand-nz): Search Air New Zealand in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
- [Fonterra company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-fonterra-nz): Search Fonterra in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
- [Spark company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-spark-nz): Search Spark in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
- [Xero company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-xero-nz): Search Xero in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
- [Fisher Paykel company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-fisher-paykel-nz): Search Fisher Paykel in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
- [Zespri company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-zespri-nz): Search Zespri in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
- [Mainfreight company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-mainfreight-nz): Search Mainfreight in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
- [Contact Energy company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-contact-energy-nz): Search Contact Energy in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
- [Ryman company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-ryman-nz): Search Ryman in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
- [Auckland company records in New Zealand](https://apify.com/scrapers_lat/newzealand-companies-scraper/examples/nzco-auckland-nz): Search Auckland in the New Zealand Companies Register: company number, status, incorporation date, directors and address.
### Related scrapers
- [Australia ABN Business Lookup Scraper](https://apify.com/scrapers_lat/australia-abn-lookup-scraper)
- [Company Research Enrichment Tool](https://apify.com/scrapers_lat/company-research-enrichment-tool)
- [Contact Enrichment Tool](https://apify.com/scrapers_lat/contact-enrichment-tool)
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for public platforms: finance, news, real estate, jobs, e-commerce and government data. Browse the full catalog or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with the New Zealand Companies Office or the New Zealand government. It only accesses publicly available company data. Use the results in accordance with the source's terms.
# Actor input Schema
## `maxCompanies` (type: `integer`):
Maximum number of New Zealand company records to collect. Optional.
## `searchQuery` (type: `string`):
A company name keyword, company number or NZBN to search the New Zealand register (for example 'air new zealand', 'construction', or a 13-digit NZBN).
## Actor input object example
```json
{
"maxCompanies": 50,
"searchQuery": "air new zealand"
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxCompanies": 50,
"searchQuery": "air new zealand"
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/newzealand-companies-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`๐พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxCompanies": 50,
"searchQuery": "air new zealand",
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/newzealand-companies-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("๐พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxCompanies": 50,
"searchQuery": "air new zealand"
}' |
apify call scrapers_lat/newzealand-companies-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/newzealand-companies-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "New Zealand Companies Register Scraper",
"description": "Search the New Zealand companies register and export company records: company number, NZBN, name, status, entity type, incorporation date and registered office address. Export to JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "8jsn0hA2DzPWbonKV"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~newzealand-companies-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-newzealand-companies-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~newzealand-companies-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-newzealand-companies-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~newzealand-companies-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-newzealand-companies-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"maxCompanies": {
"title": "Max Companies",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of New Zealand company records to collect. Optional."
},
"searchQuery": {
"title": "Company name, number or NZBN",
"type": "string",
"description": "A company name keyword, company number or NZBN to search the New Zealand register (for example 'air new zealand', 'construction', or a 13-digit NZBN)."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```