# UK Planning Applications Scraper | All Councils (`trev0n/uk-planning-applications-scraper`) Actor

Scrape UK planning applications from ~420 councils via UK PlanIt. Filter by council, postcode radius, map area, keywords, applicant company, dates, type, status and size. Monitoring mode outputs only new and updated applications.

- **URL**: https://apify.com/trev0n/uk-planning-applications-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.00 / 1,000 planning applications

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🏗️ UK Planning Applications Scraper | All Councils

🎯 **Get every new UK planning application the day it lands on a council register, filtered exactly the way you sell, build or invest.**

This scraper collects planning applications from around 420 UK planning authorities: English districts and unitaries, London boroughs, Scottish and Welsh councils, Northern Ireland districts and national parks. Each application comes with the site address and postcode, latitude and longitude, the proposal description, type, decision status, size, all key dates, applicant and agent companies, dwelling counts and direct links to the council page, documents and comments form.

### 🚀 What Does It Do?

This scraper automatically searches UK council planning registers and returns **clean, structured, ready-to-use records**. No clicking through 400 different council websites: pick your area and filters, hit Start, and get one tidy dataset.

💡 **Three ways to use it:**

1. **🔍 Search Mode**: choose councils or whole regions, a postcode radius, a map rectangle or keywords, then narrow by dates, application type, decision status and development size.
2. **📋 Direct Lookup Mode**: paste application references or planit.org.uk application links to fetch those exact applications.
3. **🔔 Monitoring Mode**: schedule it daily and receive **only applications that are new or have changed** since the last run (new decision, new status, revised description). You pay only for fresh activity, not for the same records again and again.

### 👥 Who Is This For?

| 🏢 Use Case                                           | 💬 How It Helps                                                                                                 |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| 🧱 **Builders and contractors**                       | Spot new extensions, conversions and new-build schemes in your patch before your competitors call the homeowner |
| 🪟 **Suppliers and trades**                           | Window, roofing, solar, kitchen and landscaping firms get a daily lead list of approved projects near them      |
| 🏘️ **Property developers and investors**              | Track land, major schemes and refusals across a whole region, with dwelling counts and decision dates           |
| 📐 **Architects and planning consultants**            | Watch what gets approved or refused in each council, and which agents are active where                          |
| 🏡 **Estate agents and surveyors**                    | Know about nearby planning activity that affects values before buyers ask                                       |
| 📰 **Journalists, councillors and residents' groups** | Follow controversial schemes, telecom masts or tree works in your ward and get alerted when decisions land      |

### ✨ Features

- 🇬🇧 **Whole UK coverage**: around 420 planning authorities in England, Scotland, Wales and Northern Ireland, plus national parks
- 🗺️ **Search by place your way**: council list, whole region, postcode radius, latitude/longitude radius or a map rectangle
- 📍 **Nearest first**: radius searches come back sorted by distance, with the distance in km on every record
- 🔎 **Keyword search with logic**: phrases, OR alternatives and exclusions, e.g. solar panels but not removals
- 🏢 **Applicant and agent company search**: find every scheme submitted by a given housebuilder or planning agent
- 📅 **Date filters**: received, decided or updated in the last N days, or any date range
- 🏷️ **Type, status and size filters**: full, outline, heritage, trees, telecoms, advertising and more; undecided, permitted, rejected, withdrawn; large, medium, small
- 🔔 **Monitoring mode**: only new and updated applications on every scheduled run, with change tags
- 📣 **Instant alerts**: optional Slack, Discord, Telegram or webhook message listing what is new
- 🧭 **Coordinates included**: latitude, longitude, easting and northing ready for maps and GIS
- ⚖️ **Fair per-council caps**: stop one busy council from using the whole result budget
- ⚡ **Scalable and source-friendly**: up to 300 applications per request, thousands per run, paced at one request per minute as the source asks
- 🧹 **Deduplication**: every application appears once, even when your searches overlap
- 📤 **Export Anywhere**: Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

### 🎛️ Filters & Options

| Option                                                         | What It Does                                                                            |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| 🏛️ **Councils / planning authorities**                         | Pick one or more councils, or a whole region such as London or Scotland                 |
| 📮 **Postcode (radius search)**                                | Centre a radius search on a UK postcode                                                 |
| 🌐 **Latitude / Longitude**                                    | Centre a radius search on exact coordinates                                             |
| 📏 **Radius (km)**                                             | How far around the postcode or point to search                                          |
| 🗺️ **Bounding box**                                            | Search inside a map rectangle                                                           |
| 🧩 **Exclude sub-area councils**                               | For counties and regions, keep only their own applications                              |
| 🔎 **Keywords in description**                                 | Find words or phrases in the proposal text, with OR and exclusions                      |
| 🏢 **Applicant / agent company**                               | Find applications by housebuilder, applicant or agent company                           |
| 🏷️ **Application types**                                       | Full, outline, amendments, conditions, heritage, trees, advertising, telecoms, other    |
| ✅ **Decision status**                                         | Undecided, permitted, permitted with conditions, rejected, withdrawn, referred and more |
| 📐 **Development size**                                        | Large major schemes, medium or small                                                    |
| 📥 **Received within days / from / to**                        | When the application was submitted                                                      |
| ⚖️ **Decided within days / from / to**                         | When the decision was made                                                              |
| 🔄 **Updated within days**                                     | Applications whose record changed recently, such as a new decision on an older case     |
| ↕️ **Sort by**                                                 | Newest, oldest, most recently decided or most recently updated first                    |
| 🔗 **Application references / planit.org.uk URLs**             | Fetch exact applications directly                                                       |
| 🔢 **Max results / Max results per council**                   | Control how many applications to extract per run and per council                        |
| 🧾 **Include raw source fields**                               | Add every extra field the council publishes                                             |
| 🧹 **Exclude empty fields**                                    | Leave out blank fields for leaner exports                                               |
| 🔔 **Monitoring mode, state key, unchanged output, retention** | Get only new and updated applications across scheduled runs                             |
| 📣 **Notifications**                                           | Slack, Discord, Telegram or webhook alerts after each run                               |
| ⏱️ **Seconds between requests**                                | At least 60 seconds, as the source asks                                                 |
| 🛡️ **Proxy configuration**                                     | Optional, not needed for normal use                                                     |

### 📦 What You Get (Output Fields)

Every planning application includes:

#### Identification

| Field                | Example               |
| -------------------- | --------------------- |
| applicationId        | `Leeds/26/06452/COND` |
| reference            | `26/06452/COND`       |
| latestReference      | `null`                |
| alternativeReference | `null`                |
| planningPortalId     | `PP-14450123`         |
| authority            | `Leeds`               |
| authorityId          | `292`                 |

#### Site and Location

| Field      | Example                                               |
| ---------- | ----------------------------------------------------- |
| address    | `Morley Town Hall Queen Street Morley Leeds LS27 9DY` |
| postcode   | `LS27 9DY`                                            |
| ward       | `Morley South`                                        |
| parish     | `Morley Town Council`                                 |
| district   | `null`                                                |
| uprn       | `72502341`                                            |
| latitude   | `53.745762`                                           |
| longitude  | `-1.602132`                                           |
| easting    | `425120`                                              |
| northing   | `427960`                                              |
| distanceKm | `0.42` (radius searches only)                         |

#### Proposal and Decision

| Field           | Example                                                                                                                    |
| --------------- | -------------------------------------------------------------------------------------------------------------------------- |
| description     | `Consent, agreement or approval required by condition 10 (Ceiling Finish and Repairs) of Planning Application 24/05233/LI` |
| appType         | `Conditions`                                                                                                               |
| appState        | `Undecided`                                                                                                                |
| appSize         | `Small`                                                                                                                    |
| applicationType | `Discharge of Conditions`                                                                                                  |
| developmentType | `null`                                                                                                                     |
| status          | `Current`                                                                                                                  |
| decision        | `null`                                                                                                                     |
| decidedBy       | `Delegated Decision`                                                                                                       |
| dwellingCount   | `null`                                                                                                                     |
| documentCount   | `5`                                                                                                                        |
| commentCount    | `null`                                                                                                                     |
| constraintCount | `null`                                                                                                                     |
| statutoryDays   | `56`                                                                                                                       |
| associatedIds   | `["24/05233/LI"]`                                                                                                          |

#### Dates

| Field                                                           | Example      |
| --------------------------------------------------------------- | ------------ |
| receivedDate                                                    | `2026-11-16` |
| validatedDate                                                   | `2026-11-16` |
| consultationEndDate                                             | `2026-11-27` |
| commentDeadline                                                 | `2026-12-18` |
| targetDecisionDate                                              | `2027-01-11` |
| meetingDate                                                     | `null`       |
| decidedDate                                                     | `null`       |
| permissionExpiresDate                                           | `null`       |
| appealReference, appealStatus, appealResult, appealDecisionDate | `null`       |

#### People Behind the Scheme

| Field            | Example                                      |
| ---------------- | -------------------------------------------- |
| applicantCompany | `Persimmon Homes Yorkshire`                  |
| applicantAddress | `Persimmon House Fulford York YO19 4FE`      |
| agentCompany     | `Lichfields`                                 |
| agentAddress     | `Merrion House Woodhouse Lane Leeds LS2 8LX` |
| agentPhone       | `0113 496 0123`                              |

#### Links and Tracking

| Field           | Example                                                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------------------------ |
| councilUrl      | `https://publicaccess.leeds.gov.uk/online-applications/applicationDetails.do?activeTab=summary&keyVal=TOL314JBGEU00`     |
| commentUrl      | `https://publicaccess.leeds.gov.uk/online-applications/applicationDetails.do?activeTab=makeComment&keyVal=TOL314JBGEU00` |
| documentsUrl    | `https://publicaccess.leeds.gov.uk/online-applications/applicationDetails.do?activeTab=documents&keyVal=TOL314JBGEU00`   |
| mapUrl          | `https://publicaccess.leeds.gov.uk/online-applications/applicationDetails.do?activeTab=map&keyVal=TOL314JBGEU00`         |
| planitUrl       | `https://www.planit.org.uk/planapplic/Leeds/26/06452/COND/`                                                              |
| sourceUpdatedAt | `2026-11-17T02:56:55`                                                                                                    |
| sourceCheckedAt | `2026-11-17T02:56:55`                                                                                                    |
| recordChangedAt | `2026-11-17T08:04:00`                                                                                                    |
| searchSource    | `Leeds`                                                                                                                  |
| contentHash     | `0a52965fa900697a`                                                                                                       |
| changeType      | `NEW` (monitoring mode only)                                                                                             |
| firstSeenAt     | `2026-11-18T07:00:04.112Z` (monitoring mode only)                                                                        |
| scrapedAt       | `2026-11-18T13:23:31.440Z`                                                                                               |

### 📊 Example Output

```json
{
    "applicationId": "Leeds/26/06452/COND",
    "reference": "26/06452/COND",
    "latestReference": null,
    "alternativeReference": null,
    "planningPortalId": null,
    "authority": "Leeds",
    "authorityId": 292,
    "description": "Consent, agreement or approval required by condition 10 (Ceiling Finish and Repairs) of Planning Application 24/05233/LI",
    "address": "Morley Town Hall Queen Street Morley Leeds LS27 9DY",
    "postcode": "LS27 9DY",
    "ward": "Morley South",
    "parish": "Morley Town Council",
    "district": null,
    "uprn": null,
    "latitude": 53.745762,
    "longitude": -1.602132,
    "easting": null,
    "northing": null,
    "distanceKm": null,
    "appType": "Conditions",
    "appState": "Undecided",
    "appSize": "Small",
    "applicationType": "Discharge of Conditions",
    "developmentType": null,
    "status": "Current",
    "decision": null,
    "decidedBy": "Delegated Decision",
    "receivedDate": "2026-11-16",
    "validatedDate": "2026-11-16",
    "consultationEndDate": "2026-11-27",
    "commentDeadline": "2026-12-18",
    "targetDecisionDate": "2027-01-11",
    "meetingDate": null,
    "decidedDate": null,
    "permissionExpiresDate": null,
    "applicantCompany": null,
    "applicantAddress": null,
    "agentCompany": null,
    "agentAddress": "Merrion House Woodhouse Lane Leeds LS2 8LX",
    "agentPhone": null,
    "dwellingCount": null,
    "documentCount": 5,
    "commentCount": null,
    "constraintCount": null,
    "statutoryDays": 56,
    "appealReference": null,
    "appealStatus": null,
    "appealResult": null,
    "appealDecisionDate": null,
    "associatedIds": ["24/05233/LI"],
    "councilUrl": "https://publicaccess.leeds.gov.uk/online-applications/applicationDetails.do?activeTab=summary&keyVal=TOL314JBGEU00",
    "commentUrl": "https://publicaccess.leeds.gov.uk/online-applications/applicationDetails.do?activeTab=makeComment&keyVal=TOL314JBGEU00",
    "documentsUrl": "https://publicaccess.leeds.gov.uk/online-applications/applicationDetails.do?activeTab=documents&keyVal=TOL314JBGEU00",
    "mapUrl": "https://publicaccess.leeds.gov.uk/online-applications/applicationDetails.do?activeTab=map&keyVal=TOL314JBGEU00",
    "planitUrl": "https://www.planit.org.uk/planapplic/Leeds/26/06452/COND/",
    "sourceUpdatedAt": "2026-11-17T02:56:55",
    "sourceCheckedAt": "2026-11-17T02:56:55",
    "recordChangedAt": "2026-11-17T08:04:00",
    "searchSource": "Leeds",
    "scrapedAt": "2026-11-18T13:23:31.440Z",
    "contentHash": "0a52965fa900697a"
}
```

### 🧪 Example Inputs

🧱 **Builder lead list: approved householder work within 5 km of a postcode, last 30 days**

```json
{
    "postcode": "M20 2RN",
    "radiusKm": 5,
    "receivedWithinDays": null,
    "decidedWithinDays": 30,
    "appTypes": ["Full"],
    "appStates": ["Permitted", "Conditions"],
    "maxResults": 500
}
```

☀️ **Solar installers: new solar proposals across the South West this week**

```json
{
    "authorities": ["South West"],
    "keywords": "\"solar panel\" or photovoltaic or \"solar pv\"",
    "receivedWithinDays": 7,
    "maxResults": 1000
}
```

🏘️ **Developers: daily feed of large schemes in three councils, only new and changed**

```json
{
    "authorities": ["Leeds", "Bradford", "Wakefield"],
    "appSizes": ["Large"],
    "receivedWithinDays": 60,
    "monitoringMode": true,
    "slackWebhookUrl": "https://hooks.slack.com/services/..."
}
```

### 📋 Dataset Views

The Apify Console gives you **6 ready-made table views** to quickly browse your results:

| View                | What It Shows                                                                                    |
| ------------------- | ------------------------------------------------------------------------------------------------ |
| 📊 **Overview**     | Council, reference, received date, type, status, address, postcode, description and council link |
| ⚖️ **Decisions**    | Status, decision and every key date from received to decided                                     |
| 🤝 **Leads**        | Size, number of homes, applicant and agent companies, agent address and phone                    |
| 🗺️ **Map**          | Address, postcode, coordinates, grid reference, ward and distance                                |
| 🔔 **Monitoring**   | Change tag (NEW, UPDATED), status, decision date and first-seen time                             |
| 📋 **Full Details** | Every single field, the complete dataset                                                         |

### ❓ FAQ

**🤔 Which councils are covered?**
Around 420 UK planning authorities, including every London borough, English districts, unitaries and counties, Scottish and Welsh councils, Northern Ireland districts and national parks. You can also select a whole region in one click.

**🤔 How does monitoring mode save me money?**
The first run remembers every application it found. Each later run with the same search outputs only applications that are new or whose status, decision, dates or description changed. A daily run over a busy council typically returns a small fraction of the full list, and you only pay for what is fresh.

**🤔 Why do some applications have no applicant or agent company?**
Councils publish different details. Names of private individuals are never included; company names, agent addresses and agent phone numbers appear when the council register shows them.

**🤔 How fresh is the data?**
Council registers are checked continuously and most applications appear within a day or two of being validated. Each record shows when the council page was last checked and last changed.

**🤔 Can I export the data?**
Yes, JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 How long does a run take?**
Up to 300 applications arrive with every request, and the source asks for one request per minute, so the scraper waits 60 seconds between requests. Most searches finish in a single request, under a minute. Large pulls take time: 3,000 applications need about 10 minutes, 30,000 about 100 minutes. Looking up applications by reference takes one request per reference. A daily monitoring run for a single council usually fits in one request.

**🤔 How often should I run this?**
For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks, and monitoring mode makes daily runs cheap.

**🤔 Does it work with proxies?**
No proxy is needed. If you run very frequent schedules you can optionally turn on Apify's built-in proxy service.

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional filters (minimum number of homes, specific wards or parishes, custom polygons, agent-only leads)
- 📊 Extra data fields or custom output formats
- 🔄 Integration with your CRM, Google Sheets, or database
- ⏰ Scheduled scraping with automatic deduplication
- 🌐 Scraping from other property and planning sources alongside UK council registers

👉 **Don't hesitate to reach out via private message**, I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available planning information** published by UK councils and aggregated by UK PlanIt (planit.org.uk), credited with thanks. It does not access private data, bypass authentication or collect the names of private individuals. Plans and documents linked from council sites remain the copyright of their authors. Please use the data responsibly and in compliance with applicable laws and the terms of the source.

# Actor input Schema

## `authorities` (type: `array`):

Pick one or more councils (or a whole region). Leave empty to search the whole UK by location, keywords or dates.

## `postcode` (type: `string`):

UK postcode at the centre of a radius search, e.g. "SW1A 1AA". Needs "Radius (km)".

## `latitude` (type: `string`):

Centre latitude for a radius search, e.g. "51.5074". Used instead of the postcode when set together with longitude.

## `longitude` (type: `string`):

Centre longitude for a radius search, e.g. "-0.1278".

## `radiusKm` (type: `number`):

Search radius around the postcode or point. Results come back nearest first.

## `boundingBox` (type: `string`):

Rectangle as "west,south,east,north" in degrees, e.g. "-0.16,51.52,-0.12,51.54". Ignored when a radius search is set.

## `excludeSubAreas` (type: `boolean`):

For counties, regions and combined authorities: return only their own applications, not those of the district councils inside them.

## `keywords` (type: `string`):

Text to find in the proposal description. Use quotes for phrases, "or" between alternatives and a leading dash to exclude, e.g. ""solar panel" or photovoltaic -removal".

## `developer` (type: `string`):

Find applications where this text appears in the applicant or agent company name or address, e.g. "Persimmon".

## `appTypes` (type: `array`):

Keep only these kinds of application.

## `appStates` (type: `array`):

Keep only applications with these decision outcomes.

## `appSizes` (type: `array`):

Large = major schemes (40+ homes or 100+ documents), Medium = multi-dwelling or larger, Small = everything else.

## `receivedWithinDays` (type: `integer`):

Only applications submitted in the last N days (0 = today). Ignored when a received date range is set below. With no date, location or keyword filter at all, the last 14 days are used.

## `receivedFrom` (type: `string`):

Earliest submission date (inclusive). When set, it replaces "Received within days".

## `receivedTo` (type: `string`):

Latest submission date (inclusive). When set, it replaces "Received within days".

## `decidedWithinDays` (type: `integer`):

Only applications decided in the last N days (0 = today). Ignored when a decided date range is set below.

## `decidedFrom` (type: `string`):

Earliest decision date (inclusive). When set, it replaces "Decided within days".

## `decidedTo` (type: `string`):

Latest decision date (inclusive). When set, it replaces "Decided within days".

## `updatedWithinDays` (type: `integer`):

Only applications whose record changed in the last N days, e.g. a new decision or status on an older application. Great for monitoring.

## `sortBy` (type: `string`):

Order of results. Radius searches default to nearest first.

## `applicationIds` (type: `array`):

Look up exact applications by reference, e.g. "2026/5052/T" or the unique id "Camden/2026/5052/T". Other filters are ignored for these.

## `startUrls` (type: `array`):

Application pages (https://www.planit.org.uk/planapplic/...) or search URLs (https://www.planit.org.uk/api/applics/json?...).

## `maxResults` (type: `integer`):

Maximum number of applications to return in total (0 = no limit).

## `maxResultsPerAuthority` (type: `integer`):

Cap per selected council so one busy council does not use the whole budget (0 = no cap).

## `includeRawFields` (type: `boolean`):

Add an "otherFields" object with every extra field the council register publishes.

## `excludeEmptyFields` (type: `boolean`):

Omit null and empty fields from each record.

## `monitoringMode` (type: `boolean`):

Remember what earlier runs returned and output only applications that are NEW or UPDATED (status, decision, dates, description or parties changed). The first run builds the baseline. Schedule it daily to get a feed of fresh planning activity. Applications are only ever marked as gone when the run fetched every match (no result cap reached).

## `stateKey` (type: `string`):

Name for the monitoring memory. Leave empty to derive it from your search. Use different keys for different watch lists.

## `emitUnchanged` (type: `boolean`):

In monitoring mode, output unchanged applications too (tagged UNCHANGED).

## `stateRetentionDays` (type: `integer`):

Monitoring forgets applications not seen for this many days (0 = never).

## `notifyOnlyChanges` (type: `boolean`):

Send notifications only when there are new or updated applications.

## `notificationLimit` (type: `integer`):

Maximum applications listed in one notification message.

## `webhookUrl` (type: `string`):

POST the results as JSON to this URL after each run.

## `telegramBotToken` (type: `string`):

Telegram bot token for notifications.

## `telegramChatId` (type: `string`):

Telegram chat to notify.

## `discordWebhookUrl` (type: `string`):

Discord channel webhook for notifications.

## `slackWebhookUrl` (type: `string`):

Slack incoming webhook for notifications.

## `requestIntervalSecs` (type: `integer`):

Pause between requests to the source. The source asks automated users for at least 60 seconds between requests, so 60 is the minimum. Each request returns up to 300 applications. The scraper also waits automatically whenever the source asks it to slow down.

## `proxyConfiguration` (type: `object`):

Not needed: the source is reached directly. Optional for very frequent schedules.

## Actor input object example

```json
{
  "authorities": [
    "Camden"
  ],
  "radiusKm": 2,
  "excludeSubAreas": false,
  "receivedWithinDays": 14,
  "sortBy": "default",
  "maxResults": 200,
  "maxResultsPerAuthority": 0,
  "includeRawFields": false,
  "excludeEmptyFields": false,
  "monitoringMode": false,
  "emitUnchanged": false,
  "stateRetentionDays": 180,
  "notifyOnlyChanges": true,
  "notificationLimit": 10,
  "requestIntervalSecs": 60,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `runSummary` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "authorities": [
        "Camden"
    ],
    "receivedWithinDays": 14,
    "requestIntervalSecs": 60,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/uk-planning-applications-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "authorities": ["Camden"],
    "receivedWithinDays": 14,
    "requestIntervalSecs": 60,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("trev0n/uk-planning-applications-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "authorities": [
    "Camden"
  ],
  "receivedWithinDays": 14,
  "requestIntervalSecs": 60,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call trev0n/uk-planning-applications-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,trev0n/uk-planning-applications-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/MhGkXzIGa2cjZvcHG/builds/a5qNPXqu0ftHdLJcU/openapi.json
