# England Planning Constraints Evidence Pack (`hero98/england-planning-constraints-evidence-pack`) Actor Screen 1–25 supplied England coordinates or UPRNs against official planning designations, with source-linked evidence and explicit coverage limits. - **URL**: https://apify.com/hero98/england-planning-constraints-evidence-pack.md - **Developed by:** [Suliman Tadros](https://apify.com/hero98) (community) - **Categories:** Real estate, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 location screeneds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## England Planning Constraints Evidence Pack Screen 1–25 caller-supplied England coordinates or UPRNs against selected official planning and land designations, then receive one compact, source-linked evidence record per location. This Actor uses the Ministry of Housing, Communities and Local Government's public [Planning Data API](https://www.planning.data.gov.uk/docs). It does not scrape council portals, collect applicant/owner data, download planning documents or retain a separate property database. ### What it checks - conservation areas - listed buildings - Article 4 direction areas - tree preservation zones - green belt - flood risk zones - scheduled monuments - Sites of Special Scientific Interest - ancient woodland - heritage at risk Choose any subset of those fixed layers. Each location must have your own unique label and either WGS84 latitude/longitude or a numeric UPRN. The hard limit is 25 locations per run. ### Example input ```json { "locations": [ { "label": "Trafalgar Square sample", "latitude": 51.5074, "longitude": -0.1278 }, { "label": "UPRN sample", "uprn": "10008315764" } ], "datasets": [ "conservation-area", "listed-building", "article-4-direction-area", "flood-risk-zone" ] } ```` ### Output Every successfully screened location creates one Dataset item with: - your label and exact query selector; - `MATCHES_FOUND` or `NO_MATCHES`; - total and per-dataset match counts; - compact evidence rows with the official entity ID, dataset, name, reference, dates, quality, documentation URL and stable Planning Data entity page; - screening time, source, licence attribution and the coverage warning. Failed source requests are recorded in `OUTPUT`, create no Dataset item and are not charged. Large source geometries are deliberately excluded; this is a compact evidence pack, not a GIS export. ### Important coverage boundary Planning Data is a beta service. Coverage is incomplete and varies by dataset and area. **No match does not mean no planning constraint exists.** Records can change and should be verified at the linked official source. This Actor provides research evidence only. It does not determine development rights, planning permission, legal status, insurability, valuation or whether a transaction should proceed. It is not planning, legal, surveying, conveyancing, insurance or other professional advice. ### Data and licence The source service is operated by MHCLG. Output contains public-sector information licensed under the Open Government Licence v3.0 unless an individual dataset states otherwise. Source and entity links are carried into the output. Do not imply that MHCLG, Planning Data or any source authority endorses this Actor. Your labels and locations are processed only for the run and written to your own Apify Dataset/key-value storage. The Actor does not enrich locations with people, owners or applicants and does not create a publisher-side location database. ### Pricing and limits Each successfully completed location record costs **USD 0.01** through the `location-screened` event. Apify platform usage is paid separately by the caller. Source failures are uncharged. Apify maximum-total-charge limits are respected; when the limit is reached, the Actor stops with any completed evidence already saved. ### Reliability - fixed official HTTPS endpoint; no proxy or browser - 10-second request timeout - two bounded retries for rate limits and transient server errors - 250 ms delay between completed locations - source schema validation and 100-entity response cap - no arbitrary URLs, raw API filters or unbounded pagination # Actor input Schema ## `locations` (type: `array`): One to 25 labelled locations. Give either both latitude/longitude or one numeric UPRN per row, not both. ## `datasets` (type: `array`): Choose one or more fixed official layers. Coverage varies by layer and area. ## Actor input object example ```json { "locations": [ { "label": "Trafalgar Square sample", "latitude": 51.5074, "longitude": -0.1278 } ], "datasets": [ "conservation-area", "listed-building", "article-4-direction-area", "tree-preservation-zone", "green-belt", "flood-risk-zone", "scheduled-monument", "site-of-special-scientific-interest", "ancient-woodland", "heritage-at-risk" ] } ``` # Actor output Schema ## `results` (type: `string`): No description ## `summary` (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 = { "locations": [ { "label": "Trafalgar Square sample", "latitude": 51.5074, "longitude": -0.1278 } ] }; // Run the Actor and wait for it to finish const run = await client.actor("hero98/england-planning-constraints-evidence-pack").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 = { "locations": [{ "label": "Trafalgar Square sample", "latitude": 51.5074, "longitude": -0.1278, }] } # Run the Actor and wait for it to finish run = client.actor("hero98/england-planning-constraints-evidence-pack").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 '{ "locations": [ { "label": "Trafalgar Square sample", "latitude": 51.5074, "longitude": -0.1278 } ] }' | apify call hero98/england-planning-constraints-evidence-pack --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=hero98/england-planning-constraints-evidence-pack", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "England Planning Constraints Evidence Pack", "description": "Screen 1–25 supplied England coordinates or UPRNs against official planning designations, with source-linked evidence and explicit coverage limits.", "version": "0.1", "x-build-id": "UIGeGfHU9rjZYpfyP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hero98~england-planning-constraints-evidence-pack/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hero98-england-planning-constraints-evidence-pack", "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/hero98~england-planning-constraints-evidence-pack/runs": { "post": { "operationId": "runs-sync-hero98-england-planning-constraints-evidence-pack", "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/hero98~england-planning-constraints-evidence-pack/run-sync": { "post": { "operationId": "run-sync-hero98-england-planning-constraints-evidence-pack", "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", "required": [ "locations" ], "properties": { "locations": { "title": "Locations to screen", "minItems": 1, "maxItems": 25, "type": "array", "description": "One to 25 labelled locations. Give either both latitude/longitude or one numeric UPRN per row, not both.", "items": { "type": "object", "properties": { "label": { "title": "Location label", "description": "Your own stable label for this property or site; it is returned unchanged.", "type": "string", "minLength": 1, "maxLength": 120 }, "latitude": { "title": "Latitude", "description": "WGS84 latitude within England, used together with longitude.", "type": "number", "minimum": 49, "maximum": 56 }, "longitude": { "title": "Longitude", "description": "WGS84 longitude within England, used together with latitude.", "type": "number", "minimum": -7, "maximum": 2 }, "uprn": { "title": "UPRN", "description": "Eight- to 12-digit Unique Property Reference Number, supplied as text to preserve digits.", "type": "string", "pattern": "^[0-9]{8,12}$" } }, "required": [ "label" ] } }, "datasets": { "title": "Planning designation layers", "minItems": 1, "maxItems": 10, "uniqueItems": true, "type": "array", "description": "Choose one or more fixed official layers. Coverage varies by layer and area.", "items": { "type": "string", "enum": [ "conservation-area", "listed-building", "article-4-direction-area", "tree-preservation-zone", "green-belt", "flood-risk-zone", "scheduled-monument", "site-of-special-scientific-interest", "ancient-woodland", "heritage-at-risk" ], "enumTitles": [ "Conservation area", "Listed building", "Article 4 direction area", "Tree preservation zone", "Green belt", "Flood risk zone", "Scheduled monument", "Site of Special Scientific Interest", "Ancient woodland", "Heritage at risk" ] }, "default": [ "conservation-area", "listed-building", "article-4-direction-area", "tree-preservation-zone", "green-belt", "flood-risk-zone", "scheduled-monument", "site-of-special-scientific-interest", "ancient-woodland", "heritage-at-risk" ] } } }, "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 } } } } } } } } } } ```