New Zealand LBP License Scraper

Extract New Zealand LBP license and registration records for licensed provider research, supplier screening and register monitoring. New Zealand LBP License Scraper collects public information into one complete dataset table, ready to export as Excel, CSV or JSON.

Use search filters or individual public record links, set how many results you need and start the Actor. Search finds matching records; Details retrieves the available information for records you already know.

At a glance	Details
📥 Input	Search filters or individual public record links
📋 Collection modes	Search practitioners; Get practitioner details
📤 Output	One row per record, or a failed row for an unsuccessful input
📄 Result collection	Reads the available matching collection up to maxResults
🔐 Website login	Not required
💾 Export	One dataset view with all fields; Excel, CSV and JSON

What the New Zealand LBP scraper collects 📋

Mode	What you receive
Search practitioners	Matching license and registration records and the fields published in the search results.
Get practitioner details	Available public information for each supplied record. The full output example below shows its actual fields.

The field table and complete examples below show the information this Actor returns. Optional values depend on what the source publishes for the selected record.

Coverage for this Actor:

• Covers the public New Zealand Licensed Building Practitioners register. Searches can be narrowed by city, surname or company.
• Contact details are included only when the practitioner makes them public. Qualifications, disciplinary history and associated companies are not included unless published in the retrieved record.

How to scrape New Zealand LBP 🚀

1. Choose Search practitioners or Get practitioner details.
2. Complete the search filters or individual public record links.
3. Set Maximum results. The minimum is 1.
4. Start the Actor and review the saved dataset.
5. Export the results or connect them to your workflow.

Search practitioners — input example

{
  "mode": "search",
  "city": "Auckland",
  "maxResults": 100
}

Get practitioner details — input example

{
  "mode": "details",
  "recordUrls": [
    "https://kete-lbp.mbie.govt.nz/practitioner/?id=588f8bdf-47de-e411-87d7-005056ae0567"
  ],
  "maxResults": 1
}

maxResults limits all saved rows for each search or supplied record, including a failed row. It does not guarantee that the source has that many matching records. A detail lookup normally returns one record, although sources with multiple revisions or establishments can return more.

New Zealand LBP data fields and complete output 📦

Each result stays in one row. Every returned field appears in the same dataset view, including list fields and additional published facts. Fields unavailable for a particular record remain empty.

Field	Included data
result_type	Selected collection mode.
input	Submitted search settings, record link or record number.
status	Collection status for this record.
error_code	Failure category for an unsuccessful input.
error_message	Readable explanation for an unsuccessful input.
record_id	Stable identifier assigned by the source, or its persistent profile slug.
name	Published name of the company, product, institution or licence holder.
url	Public page for this record; absent when no public profile link is supplied.
city	Published city.
region	Published region.
currently_licensed	Whether the directory marks the practitioner as currently licensed.
additional_fields.name	Names of additional published fields, when present.
additional_fields.value	Their corresponding values in the same order.
practitioner_number	Public building practitioner number.
first_licence_granted	Date the practitioner first received a licence.
postcode	Published postal code.
email	Public email address or addresses.
mobile	Public mobile contact number.
daytime_phone	Public daytime telephone number.

The complete result below is included for every mode. Text and lists are not shortened. These are examples from validation runs; the source can change.

Search practitioners — complete JSON result

{
  "result_type": "search",
  "input": "{\"city\": \"Auckland\", \"company\": \"\", \"lastName\": \"\"}",
  "status": "success",
  "record_id": "588f8bdf-47de-e411-87d7-005056ae0567",
  "name": "Aaron Aukett",
  "url": "https://kete-lbp.mbie.govt.nz/practitioner/?id=588f8bdf-47de-e411-87d7-005056ae0567",
  "city": "Auckland",
  "region": "Auckland Region",
  "currently_licensed": true,
  "additional_fields.name": [],
  "additional_fields.value": []
}

Get practitioner details — complete JSON result

{
  "result_type": "details",
  "input": "https://kete-lbp.mbie.govt.nz/practitioner/?id=588f8bdf-47de-e411-87d7-005056ae0567",
  "status": "success",
  "record_id": "588f8bdf-47de-e411-87d7-005056ae0567",
  "name": "Aaron Aukett",
  "url": "https://kete-lbp.mbie.govt.nz/practitioner/?id=588f8bdf-47de-e411-87d7-005056ae0567",
  "practitioner_number": "BP128777",
  "first_licence_granted": "2025-05-14T00:00:00.0000000Z",
  "region": "Auckland Region",
  "city": "Auckland",
  "postcode": "2018",
  "email": "aaron_a85@live.com",
  "mobile": "0211703145",
  "daytime_phone": "0211703145",
  "additional_fields.name": [],
  "additional_fields.value": []
}

Input settings ⚙️

Setting	What to enter
What to collect (mode)	Choose the information you need.
Maximum results per search or link (maxResults)	Collect up to this many saved results for each search or record link. Minimum: 1.
Town or city (city)	Town or city.
Last name (lastName)	Last name.
Company name (company)	Company name.
Practitioner links (recordUrls)	Paste one individual public record link per line. Use this field in Details mode.

New Zealand LBP scraping use cases 🎯

Find registered providers

Search the supported register using names, locations, license categories or other available fields.

Review published registration details

Collect available license numbers, organization names, status and scope before conducting your own review.

Monitor register changes

Compare exports by stable record ID to identify changes in published registration details. A record alone is not an endorsement or a substitute for an official certificate.

Pricing and saved-result behavior 💰

See the Actor’s Pricing tab for the current rate. Under dataset-item pricing:

• Each saved record is one result. Lists and additional details attached to it do not create extra rows.
• A saved failed row is also one billable dataset item. This includes invalid inputs, unavailable records, empty searches and exhausted retries.
• At most one failed row is saved per input. Retry attempts do not create additional dataset rows.
• maxResults caps all saved rows for the input. Duplicate copies of the same input are processed once.

New Zealand LBP scraper API and integrations 🔌

Replace $ACTOR_ID with the ID shown in the Actor’s API tab and $APIFY_TOKEN with your Apify token.

curl -X POST "https://api.apify.com/v2/acts/$ACTOR_ID/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"search","city":"Auckland","maxResults":100}'

Use Apify schedules for recurring collection, webhooks for completion notifications, and integrations for Google Sheets, Make, Zapier, cloud storage or your own application.

Reliability and public-data limits ⚠️

Temporary request failures are retried up to five total attempts. Invalid record inputs save a failed row without a website request. Confirmed missing records are not retried unnecessarily. If a later request fails, records already saved remain in the dataset. Normal pagination completion does not add a failed row. Collection stops after two consecutive pages return no new records. Configuration, data-saving or request-scheduling failures stop the run.

New Zealand LBP controls the available records and fields. Search records can contain less information than a full public card. The Actor preserves published values and does not fill missing facts with estimates.

Frequently asked questions ❓

Do I need a New Zealand LBP account?

No. This Actor collects the supported public information without your website login.

Which search filters can I use?

The input form supports town or city, last name, company name. Only the displayed filters are supported.

How many records can I collect?

Set maxResults to the maximum saved rows you want for each input. The minimum is 1. Collection can finish earlier when the source runs out of results or stops returning new records.

Why are some fields empty?

The source may not publish a value for that record or mode. Optional information remains empty.

Can I export all the fields?

Yes. All returned fields are included in one dataset view. Nested lists remain attached to their parent record.

Support 🛟

For a reproducible issue, share the run ID, selected mode and a safe public example through the Actor’s support channel. Keep tokens, passwords and proxy credentials private.