REST API · bulk export · webhooks

The only Irish construction-data API - in your stack.

No other Irish construction-leads source gives you the data programmatically. Planning applications, commencement notices, strategic-infrastructure and energy projects, company firmographics and market intelligence behind one REST endpoint - 214,543 records across all 31 authorities, updated weekly. Query it, bulk-export it, or have matching leads pushed to you every hour.

Data Processing Addendum · SLA · Status · Security

REST over HTTPS · Bearer auth · cursor-paginated exports · OpenAPI spec.

Access levels

Three levels, one API

Access is set by the scope on your key, not by the plan on your account. Every level speaks the same endpoints and the same response shapes, so moving up is a new key, not a new integration.

Commonwealth

commonwealth
Free, any account

Building something on the public record, or trying the API before you commit.

Rate
600 requests / hour
Bulk & keyed reads
1,000 rows a day
  • The public, PII-free planning record across all 31 authorities
  • Same endpoints, same shapes, same OpenAPI spec as every level above
  • Attribution required; no redistribution

Enterprise API

ent_api
Included with Max

A commercial team pulling leads into a CRM, a warehouse or an internal tool.

Rate
5,000 requests / hour
Bulk & keyed reads
5,000 rows a day
  • The enriched dataset: named applicant, firmographics, Company 360 profiles
  • Bulk export as CSV or JSONL, and signed webhooks pushing new matches hourly
  • Licensed for your own organisation's use

Enterprise Feed

ent_feed · custom
Under a data licence

A utility, authority or consultancy putting the dataset on a map, or redistributing it.

Rate
20,000 / hour
Bulk & keyed reads
Uncapped
  • Two GeoJSON layers QGIS and ArcGIS Pro read natively, planning and infrastructure
  • No daily row budget, on export or on keyed paging
  • Redistribution rights, a published SLA and DPA, and a fixed term with named seats
  • A Custom plan lifts the rate to 120,000 an hour for a bespoke integration

A Max subscription does not reach the feed scopes on its own: those come with an agreement, because they carry redistribution rights and a service level. Once one is signed we record the licence against your organisation and you create the key yourself, in your own browser. We never see it and cannot re-send it. See the Enterprise page for what the agreement covers, or pricing for the plans below it.

Two construction professionals reviewing plans on a tablet on site

The only Irish construction dataset you can wire straight into your stack, your CRM, your tools.

What you can pull

The dataset on tap - what no one else offers

Leads - search & filter

GET /v1/leads with full querying: text, vertical, authority, readiness, min_value, min_units, has_contact. Keyset-paginated.

GIS feed - GeoJSON

GET /v1/feeds/leads.geojson: the pipeline as a layer for QGIS or ArcGIS Pro, filtered by bounding box, authority or date, with a stable integer feature id so a refresh tells an update from an insert. Feed licence.

Bulk export

Stream a filtered slice as JSONL for ETL & pandas, or pull it as a one-shot CSV. Cursor-paginated, with a daily row budget on standard keys and no cap on a Feed licence. Max. Pro can download its filtered list as CSV from the app, with the applicant and company columns blank.

Lead detail - company 360

GET /v1/leads/{id}: project, zoning & appeals, area comparables, suppliers, the appointed main contractor, plus the registered company and its CRO filing history.

Market intelligence

GET /v1/intel/analytics: yield estimates, a repeat-sale price index, emerging zones and material-cost trends - all PII-free.

Webhooks

Push delivery of new leads matching your saved filters - HMAC-signed, no polling. lead.new events, delivered hourly.

Infrastructure & energy

GET /v1/infrastructure for the strategic-infrastructure pipeline (data centres, wind, solar, battery, grid), GET /v1/feeds/infrastructure.geojson for the same pipeline as a GIS layer carrying the applicant and, on 55% of projects, the connection voltage, and GET /v1/infrastructure/renewables for every renewable case lodged with An Coimisiun Pleanala since January 2025, with technology, consenting route and the RED III fast lane flagged.

Usage ledger

GET /v1/account/usage returns what each of your keys did - requests, errors and a breakdown by route - so you can attribute spend and spot a runaway job. Revoked keys keep their history. A permanent per-key daily count backs it, so consumption can be evidenced over a whole licence term, not just the recent window the detailed ledger holds.

OpenAPI spec

Every endpoint, parameter and response schema in a machine-readable openapi.json - generate clients, browse Swagger or ReDoc.

Quickstart

Authenticated in one header

Create a free key on any plan, then send it as a Bearer token on any read endpoint. Every response carries X-RateLimit-* headers so you can back off cleanly.

bash
# Authenticate any read endpoint with your Bearer key.
curl -H "Authorization: Bearer pl_live_…" \
  "https://planningleads.ie/api/v1/leads?readiness=commencing&vertical=solar&min_units=20"

Bulk-export the dataset

import pandas as pd, requests

# Stream the whole filtered dataset as JSONL straight into a DataFrame.
url = "https://planningleads.ie/api/v1/export/applications.jsonl"
headers = {"Authorization": "Bearer pl_live_…"}
params = {"readiness": "commencing", "min_units": 20}

resp = requests.get(url, headers=headers, params=params, stream=True)
df = pd.read_json(resp.raw, lines=True)

print(df[["planning_authority", "est_value", "lead_readiness"]].head())

Individual (homeowner) names are masked at every tier - there is no bulk export of homeowner PII. The named organisation behind a row is a Max field, so a Pro export carries those two columns blank rather than dropping them.

Add it to your GIS

bash
# Add the live pipeline to QGIS or ArcGIS Pro as a layer.
# QGIS: Layer > Add Layer > Add Vector Layer, Protocol HTTP(S), and this URL,
# with Authentication set to a Bearer token.
curl -H "Authorization: Bearer pl_live_…" \
  "https://planningleads.ie/api/v1/feeds/leads.geojson?page_size=5000&updated_since=2026-09-01"

# Filter the layer the way you would any other: by bounding box, by authority,
# or by date so a scheduled refresh pulls only what changed.
#   ?bbox=-6.30,53.33,-6.25,53.36
#   ?authority=Dublin%20City%20Council
#   ?since=2026-09-01        # first seen
#   ?updated_since=2026-09-01  # changed since

# The strategic pipeline is a second layer: every project An Coimisiun Pleanala
# consents directly, with capacity in MW, connection voltage and auction round.
curl -H "Authorization: Bearer pl_live_…" \
  "https://planningleads.ie/api/v1/feeds/infrastructure.geojson?vertical=battery_storage&min_mw=50"

Every feature is a point with its full record attached and a link back to its public page. Needs a Feed licence key.

Webhooks

New matching leads, pushed to you - no polling

Register a webhook and we POST leads that match your saved filters the moment they appear. Each request is HMAC-SHA256 signed with an X-PL-Signature header - recompute it over the raw body and compare timing-safe. The docs carry copy-paste Python and Node verification snippets.

lead.new

Built for

Wire it into the tools you already run

QS & estimating tools

Pull commencing schemes by unit count and estimated value, with material-cost trends to feed pricing models and BoQs.

Proptech & CRMs

Sync filtered leads and company 360 records straight into your pipeline; get new matches pushed over webhooks as they file.

Investors & analysts

Query the repeat-sale index, yield estimates and emerging zones across 790k PPR sales to back development and acquisition calls.

Estate agents

Track planning and commencements in your patch, surface the developer behind each site, and reach out before it lists.

Utilities, grid & energy consultants

Where connection demand is forming: grid-scale battery storage told apart from domestic, substation and line consents, the renewable cases in the RED III fast lane, RESS auction winners flagged on the applications they name, and the CRU connection rule surfaced on data-centre schemes.

PII-safe by design

Organisation-level data only - individual (homeowner) names are masked. Built around Ireland's open-data licence and GDPR.

Rate-limited & paginated

Standard X-RateLimit-* headers (Reset is epoch seconds) and cursor-paginated exports keep large pulls stable and predictable.

Published terms

A Data Processing Addendum, an SLA with a 99.5% availability target and a 90-day deprecation notice, and a live status page - all published, not on request.

Start building.

Get a free commonwealth key on any plan. Max adds the enriched fields, bulk export and webhooks. The GIS feeds and uncapped bulk need a Feed licence, which comes with an Enterprise agreement.