SiteLens API
Planning intelligence in your own systems
A live feed of recent UK planning applications and decisions, delivered into your CRM or internal tools: classified applications, works tagging, source-labelled business contacts, Companies House matches and alert feeds. JSON over HTTPS, authenticated with an API key, or a CSV export of the same filtered search.
Three ways to integrate
Live API
Your system calls SiteLens when it needs a record or a search.
Polled feed
Pull new alert matches with a since cursor, and decision changes through the changes feed, on your own schedule.
CSV export
A CSV endpoint with the same filters as search, for the recent records you want as a file.
A live feed, not an archive
The API serves planning applications and decisions that were validated, received, decided or changed in status in the last 90 days, plus refreshes of records you already hold. It keeps your own systems current; it is not a historical archive. New applications and decision changes arrive through a changes feed that your system polls, covering the last 30 days.
When your subscription ends, updates stop, and within 30 days you delete the data and anything built from it.
Authentication
curl "https://api.sitelens.co.uk/v1/applications?lat=55.03&lon=-1.59&radius_km=50&works_tags=renewables&is_major=true" \ -H "Authorization: Bearer sl_live_your_key_here"
Keys are created in dashboard settings once your agreement is in place, shown once, and revocable at any time. 2 active keys per account.
Endpoints
Full interactive reference (Swagger): /features/api/reference. The machine-readable OpenAPI document is served by the API itself at GET /v1/openapi.json.
| Endpoint | What it returns |
|---|---|
GET /v1/applications | Filtered search: postcode radius or map bounds, categories, works tags (e.g. renewables), use classes (e.g. B8), major-only, decision, dates, value band. Paginated JSON. |
GET /v1/applications/{id} | Full application detail, including named parties, business contact details with their source where the party is a business, classification and constraint flags. |
GET /v1/applications/{id}/history | Status and decision history for one application. |
GET /v1/export | The same search, returned as CSV (up to 2,500 rows a call), for pulling recent records into a file or a tool. |
GET /v1/companies/{ch} | Company profile by Companies House number: status, filings signals, recent applications in your coverage and approval rate. Contact lookups run in your dashboard, from the 100 a month your plan includes; contact details on API records do not count towards them. |
GET /v1/alerts | Your alert definitions. |
GET /v1/alerts/{id}/matches?since= | Matches for one alert since a timestamp, using the same matcher as its email, within your coverage and the live window: new applications, decisions or work starting, by the alert's type. Poll it on your own schedule. |
GET /v1/changes?cursor= | The changes feed: new applications and decision changes in your coverage, oldest first, up to 500 a page, covering the last 30 days. Poll it once a day; a missed day picks up where the last poll stopped. |
GET /v1/leads | Your saved lead pipeline, read-only, for mirroring into your CRM. |
GET /v1/tombstones?since= | Records you must refresh or delete (data-protection propagation). Consuming this feed is part of the licence. |
GET /v1/usage | Your meters: requests this month, contact lookups, coverage. |
Pricing
API Regional
£149/mo billed annually
£1,788 a year. You pick the councils you need, up to 75 (around 2 to 3 regions). Up to 40,000 new records a month (refreshes and the initial load in your first 30 days do not count). Includes Team seats for up to 5 people and 100 contact lookups a month in the dashboard.
API National
£229/mo billed annually
£2,748 a year. All 380+ councils. Up to 200,000 new records a month (refreshes and the initial load in your first 30 days do not count). Includes Team seats for up to 5 people and 100 contact lookups a month in the dashboard.
Limits, per account
- 300 requests a minute per key.
- 100,000 requests a month.
- 40,000 (Regional) or 200,000 (National) new records a month. Refreshes of records you already hold, and the initial load in your first 30 days, do not count.
- 2 active keys.
- Coverage is fixed to the councils agreed with you.
Annual billing only. Need webhooks, higher volumes or bespoke terms? Email hello@sitelens.co.uk.
Licence
The data is licensed for your own internal use, in your own systems. You may not pass it on, show it or sell it to clients or anyone else, and that includes any list, report or other output built from it.
If you are a planning professional, you may cite an individual application by its public register details (reference, address, description, dates and decision) in advice to a client about that client's own site or application, but not pass on lists, contact details or our classifications.
Client-facing use, or resale, needs a separate licence. Email hello@sitelens.co.uk.
Data and your responsibilities
Contact details are supplied where the named party is a business, each labelled with where it came from, and pattern matches are marked unverified. Where an applicant is a private individual we supply no personal details at all. Where an agent is a private individual we supply the name and correspondence address only, never an email address or phone number. Some values are excluded at source because our upstream licences do not permit them in an export.
Once data is in your systems you are its data controller. The API terms set out what that means in practice, including: no reselling or republishing the data, no direct marketing use of any value we flag as Land Registry sourced, your own screening obligations (TPS/CTPS/MPS) for any outreach you run, a privacy notice that names SiteLens as the source, acting on the tombstones feed within 7 days, refreshing stored records at least every 30 days, and reproducing the source attributions where the data is displayed. The full terms are in the agreement you sign.
Ready to integrate?
Email hello@sitelens.co.uk with the areas you need covered and how you want the data to arrive, and we'll get you set up.
How buying works: a short agreement, signed by a director; an annual invoice on 14 day terms; and your keys, created in the dashboard once the agreement is in place.
Your first annual payment carries the same 30-day money-back guarantee as Pro and Team: email us within 30 days and we refund it in full, and API access ends that day.