{
  "openapi": "3.0.1",
  "info": {
    "title": "UK Planning Applications Scraper | All Councils",
    "description": "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.",
    "version": "1.0",
    "x-build-id": "a5qNPXqu0ftHdLJcU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/trev0n~uk-planning-applications-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-trev0n-uk-planning-applications-scraper",
        "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/trev0n~uk-planning-applications-scraper/runs": {
      "post": {
        "operationId": "runs-sync-trev0n-uk-planning-applications-scraper",
        "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/trev0n~uk-planning-applications-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-trev0n-uk-planning-applications-scraper",
        "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",
        "properties": {
          "authorities": {
            "title": "Councils / planning authorities",
            "type": "array",
            "description": "Pick one or more councils (or a whole region). Leave empty to search the whole UK by location, keywords or dates.",
            "items": {
              "type": "string",
              "enum": [
                "London",
                "South East",
                "South West",
                "East England",
                "East Midlands",
                "West Midlands",
                "North East",
                "North West",
                "Yorkshire and Humber",
                "Scotland",
                "Wales",
                "Northern Ireland",
                "Channel Islands",
                "Isle of Man",
                "Aberdeen",
                "Aberdeenshire",
                "Adur and Worthing",
                "Alderney",
                "Allerdale",
                "Amber Valley",
                "Anglesey",
                "Angus",
                "Antrim and Newtownabbey",
                "Ards and North Down",
                "Argyll",
                "Armagh Banbridge Craigavon",
                "Arun",
                "Ashfield",
                "Ashford",
                "BCP",
                "Babergh Mid Suffolk",
                "Barking and Dagenham",
                "Barnet",
                "Barnsley",
                "Barrow",
                "Basildon",
                "Basingstoke",
                "Bassetlaw",
                "Bath",
                "Bedford",
                "Belfast",
                "Bexley",
                "Birmingham",
                "Blaby",
                "Blackburn",
                "Blackpool",
                "Blaenau Gwent",
                "Bolsover",
                "Bolton",
                "Boston",
                "Bracknell",
                "Bradford",
                "Braintree",
                "Breckland",
                "Brecon Beacons",
                "Brent",
                "Brentwood",
                "Bridgend",
                "Brighton",
                "Bristol",
                "Broads",
                "Bromley",
                "Bromsgrove Redditch",
                "Broxbourne",
                "Broxtowe",
                "Buckinghamshire",
                "Burnley",
                "Bury",
                "Caerphilly",
                "Cairngorms",
                "Calderdale",
                "Cambridge",
                "Cambridgeshire",
                "Camden",
                "Cannock Chase",
                "Canterbury",
                "Cardiff",
                "Carlisle",
                "Carmarthenshire",
                "Castle Point",
                "Causeway and Glens",
                "Central Bedfordshire",
                "Ceredigion",
                "Charnwood",
                "Chelmsford",
                "Cheltenham",
                "Cherwell",
                "Cheshire East",
                "Chester",
                "Chesterfield",
                "Chichester",
                "Chorley",
                "City",
                "Clackmannanshire",
                "Colchester",
                "Conwy",
                "Copeland",
                "Cornwall",
                "Cotswold",
                "Coventry",
                "Craven",
                "Crawley",
                "Croydon",
                "Cumbria",
                "DNS Wales",
                "Dacorum",
                "Darlington",
                "Dartford",
                "Dartmoor",
                "Denbighshire",
                "Derby",
                "Derbyshire",
                "Derbyshire Dales",
                "Derry and Strabane",
                "Devon",
                "Doncaster",
                "Dorset",
                "Dover",
                "Dudley",
                "Dumfries",
                "Dundee",
                "Durham",
                "Ealing",
                "East Ayrshire",
                "East Cambridgeshire",
                "East Devon",
                "East Dunbartonshire",
                "East Hampshire",
                "East Hertfordshire",
                "East Lindsey",
                "East Lothian",
                "East Renfrewshire",
                "East Riding",
                "East Staffordshire",
                "East Suffolk",
                "East Sussex",
                "Eastbourne",
                "Eastleigh",
                "Edinburgh",
                "Elmbridge",
                "Energy Consents Unit",
                "Enfield",
                "Epping Forest",
                "Epsom and Ewell",
                "Erewash",
                "Essex",
                "Exeter",
                "Exmoor",
                "Falkirk",
                "Fareham",
                "Fenland",
                "Fermanagh and Omagh",
                "Fife",
                "Flintshire",
                "Forest of Dean",
                "Fylde",
                "Gateshead",
                "Gedling",
                "Glamorgan",
                "Glasgow",
                "Gloucester",
                "Gloucestershire",
                "Gosport",
                "Gravesham",
                "Great Yarmouth",
                "Greenwich",
                "Guernsey",
                "Guildford",
                "Gwynedd",
                "Hackney",
                "Halton",
                "Hambleton",
                "Hammersmith and Fulham",
                "Hampshire",
                "Harborough",
                "Haringey",
                "Harlow",
                "Harrogate",
                "Harrow",
                "Hart",
                "Hartlepool",
                "Hastings",
                "Havant",
                "Havering",
                "Herefordshire",
                "Hertfordshire",
                "Hertsmere",
                "High Peak",
                "Highland",
                "Hillingdon",
                "Hinckley and Bosworth",
                "Horsham",
                "Hounslow",
                "Hull",
                "Huntingdonshire",
                "Hyndburn",
                "Inverclyde",
                "Ipswich",
                "Isle of Wight",
                "Islington",
                "Jersey",
                "Kensington",
                "Kent",
                "Kings Lynn",
                "Kingston",
                "Kirklees",
                "Knowsley",
                "Lake District",
                "Lambeth",
                "Lancashire",
                "Lancaster",
                "Leeds",
                "Leicester",
                "Leicestershire",
                "Lewes",
                "Lewisham",
                "Lichfield",
                "Lincoln",
                "Lincolnshire",
                "Lisburn and Castlereagh",
                "Liverpool",
                "Loch Lomond",
                "Luton",
                "Maldon",
                "Malvern Hills",
                "Manchester",
                "Mansfield",
                "Medway",
                "Melton",
                "Mendip",
                "Merthyr Tydfil",
                "Merton",
                "Mid Devon",
                "Mid East Antrim",
                "Mid Kent",
                "Mid Sussex",
                "Mid Ulster",
                "Middlesbrough",
                "Midlothian",
                "Milton Keynes",
                "Mole Valley",
                "Monmouthshire",
                "Moray",
                "NI Strategic Planning",
                "NSIP England",
                "NSIP Wales",
                "Neath",
                "New Forest (District)",
                "New Forest (Park)",
                "Newark and Sherwood",
                "Newcastle under Lyme",
                "Newcastle upon Tyne",
                "Newham",
                "Newport",
                "Newry Mourne Down",
                "Norfolk",
                "North Ayrshire",
                "North Devon",
                "North East Derbyshire",
                "North East Lincs",
                "North Hertfordshire",
                "North Kesteven",
                "North Lanarkshire",
                "North Lincs",
                "North Norfolk",
                "North Northamptonshire",
                "North Somerset",
                "North Tyneside",
                "North Warwickshire",
                "North West Leicestershire",
                "North York Moors",
                "North Yorkshire",
                "Northumberland (County)",
                "Northumberland (Park)",
                "Norwich",
                "Nottingham",
                "Nottinghamshire",
                "Nuneaton",
                "Oadby and Wigston",
                "Old Oak Park Royal",
                "Oldham",
                "Orkney",
                "Oxford",
                "Oxfordshire",
                "Peak District",
                "Pembroke Coast",
                "Pembrokeshire",
                "Pendle",
                "Perth",
                "Peterborough",
                "Plymouth",
                "Portsmouth",
                "Powys",
                "Preston",
                "Reading",
                "Redbridge",
                "Redcar and Cleveland",
                "Reigate",
                "Renfrewshire",
                "Rhondda",
                "Ribble Valley",
                "Richmond",
                "Richmondshire",
                "Rochdale",
                "Rochford",
                "Rossendale",
                "Rother",
                "Rotherham",
                "Rugby",
                "Runnymede",
                "Rushcliffe",
                "Rushmoor",
                "Rutland",
                "Ryedale",
                "Salford",
                "Sandwell",
                "Scarborough",
                "Scilly Isles",
                "Scottish Borders",
                "Sedgemoor",
                "Sefton",
                "Selby",
                "Sevenoaks",
                "Sheffield",
                "Shepway",
                "Shetlands",
                "Shropshire",
                "Slough",
                "Snowdonia",
                "Solihull",
                "Somerset",
                "South Ayrshire",
                "South Cambridgeshire",
                "South Derbyshire",
                "South Downs",
                "South Gloucestershire",
                "South Holland",
                "South Kesteven",
                "South Lanarkshire",
                "South Norfolk Broadland",
                "South Oxfordshire",
                "South Ribble",
                "South Somerset",
                "South Staffordshire",
                "South Tyneside",
                "South West Devon",
                "Southampton",
                "Southend",
                "Southwark",
                "Spelthorne",
                "St Albans",
                "St Helens",
                "Stafford",
                "Staffordshire",
                "Staffordshire Moorlands",
                "Stevenage",
                "Stirling",
                "Stockport",
                "Stockton-on-Tees",
                "Stoke on Trent",
                "Stratford on Avon",
                "Stroud",
                "Suffolk",
                "Sunderland",
                "Surrey",
                "Surrey Heath",
                "Sutton",
                "Swansea",
                "Swindon",
                "Tameside",
                "Tamworth",
                "Tandridge",
                "Taunton Deane",
                "Teignbridge",
                "Telford",
                "Tendring",
                "Test Valley",
                "Tewkesbury",
                "Thanet",
                "Three Rivers",
                "Thurrock",
                "Tonbridge",
                "Torbay",
                "Torfaen",
                "Torridge",
                "Tower Hamlets",
                "Trafford",
                "Tunbridge Wells",
                "Uttlesford",
                "Vale of White Horse",
                "Wakefield",
                "Walsall",
                "Waltham Forest",
                "Wandsworth",
                "Warrington",
                "Warwick",
                "Warwickshire",
                "Watford",
                "Waverley",
                "Wealden",
                "Welwyn Hatfield",
                "West Berkshire",
                "West Dunbartonshire",
                "West Lancashire",
                "West Lindsey",
                "West Lothian",
                "West Northamptonshire",
                "West Oxfordshire",
                "West Somerset",
                "West Suffolk",
                "West Sussex",
                "Western Isles",
                "Westminster",
                "Westmorland and Furness",
                "Wigan",
                "Wiltshire",
                "Winchester",
                "Windsor",
                "Wirral",
                "Woking",
                "Wokingham",
                "Wolverhampton",
                "Worcester",
                "Worcestershire",
                "Wrexham",
                "Wychavon",
                "Wyre",
                "Wyre Forest",
                "York",
                "Yorkshire Dales"
              ],
              "enumTitles": [
                "Region: London (all councils)",
                "Region: South East (all councils)",
                "Region: South West (all councils)",
                "Region: East England (all councils)",
                "Region: East Midlands (all councils)",
                "Region: West Midlands (all councils)",
                "Region: North East (all councils)",
                "Region: North West (all councils)",
                "Region: Yorkshire and Humber (all councils)",
                "Region: Scotland (all councils)",
                "Region: Wales (all councils)",
                "Region: Northern Ireland (all councils)",
                "Region: Channel Islands (all councils)",
                "Region: Isle of Man (all councils)",
                "Aberdeen",
                "Aberdeenshire",
                "Adur and Worthing",
                "Alderney",
                "Allerdale",
                "Amber Valley",
                "Anglesey",
                "Angus",
                "Antrim and Newtownabbey",
                "Ards and North Down",
                "Argyll",
                "Armagh Banbridge Craigavon",
                "Arun",
                "Ashfield",
                "Ashford",
                "BCP",
                "Babergh Mid Suffolk",
                "Barking and Dagenham",
                "Barnet",
                "Barnsley",
                "Barrow",
                "Basildon",
                "Basingstoke",
                "Bassetlaw",
                "Bath",
                "Bedford",
                "Belfast",
                "Bexley",
                "Birmingham",
                "Blaby",
                "Blackburn",
                "Blackpool",
                "Blaenau Gwent",
                "Bolsover",
                "Bolton",
                "Boston",
                "Bracknell",
                "Bradford",
                "Braintree",
                "Breckland",
                "Brecon Beacons",
                "Brent",
                "Brentwood",
                "Bridgend",
                "Brighton",
                "Bristol",
                "Broads",
                "Bromley",
                "Bromsgrove Redditch",
                "Broxbourne",
                "Broxtowe",
                "Buckinghamshire",
                "Burnley",
                "Bury",
                "Caerphilly",
                "Cairngorms",
                "Calderdale",
                "Cambridge",
                "Cambridgeshire",
                "Camden",
                "Cannock Chase",
                "Canterbury",
                "Cardiff",
                "Carlisle",
                "Carmarthenshire",
                "Castle Point",
                "Causeway and Glens",
                "Central Bedfordshire",
                "Ceredigion",
                "Charnwood",
                "Chelmsford",
                "Cheltenham",
                "Cherwell",
                "Cheshire East",
                "Chester",
                "Chesterfield",
                "Chichester",
                "Chorley",
                "City",
                "Clackmannanshire",
                "Colchester",
                "Conwy",
                "Copeland",
                "Cornwall",
                "Cotswold",
                "Coventry",
                "Craven",
                "Crawley",
                "Croydon",
                "Cumbria",
                "DNS Wales",
                "Dacorum",
                "Darlington",
                "Dartford",
                "Dartmoor",
                "Denbighshire",
                "Derby",
                "Derbyshire",
                "Derbyshire Dales",
                "Derry and Strabane",
                "Devon",
                "Doncaster",
                "Dorset",
                "Dover",
                "Dudley",
                "Dumfries",
                "Dundee",
                "Durham",
                "Ealing",
                "East Ayrshire",
                "East Cambridgeshire",
                "East Devon",
                "East Dunbartonshire",
                "East Hampshire",
                "East Hertfordshire",
                "East Lindsey",
                "East Lothian",
                "East Renfrewshire",
                "East Riding",
                "East Staffordshire",
                "East Suffolk",
                "East Sussex",
                "Eastbourne",
                "Eastleigh",
                "Edinburgh",
                "Elmbridge",
                "Energy Consents Unit",
                "Enfield",
                "Epping Forest",
                "Epsom and Ewell",
                "Erewash",
                "Essex",
                "Exeter",
                "Exmoor",
                "Falkirk",
                "Fareham",
                "Fenland",
                "Fermanagh and Omagh",
                "Fife",
                "Flintshire",
                "Forest of Dean",
                "Fylde",
                "Gateshead",
                "Gedling",
                "Glamorgan",
                "Glasgow",
                "Gloucester",
                "Gloucestershire",
                "Gosport",
                "Gravesham",
                "Great Yarmouth",
                "Greenwich",
                "Guernsey",
                "Guildford",
                "Gwynedd",
                "Hackney",
                "Halton",
                "Hambleton",
                "Hammersmith and Fulham",
                "Hampshire",
                "Harborough",
                "Haringey",
                "Harlow",
                "Harrogate",
                "Harrow",
                "Hart",
                "Hartlepool",
                "Hastings",
                "Havant",
                "Havering",
                "Herefordshire",
                "Hertfordshire",
                "Hertsmere",
                "High Peak",
                "Highland",
                "Hillingdon",
                "Hinckley and Bosworth",
                "Horsham",
                "Hounslow",
                "Hull",
                "Huntingdonshire",
                "Hyndburn",
                "Inverclyde",
                "Ipswich",
                "Isle of Wight",
                "Islington",
                "Jersey",
                "Kensington",
                "Kent",
                "Kings Lynn",
                "Kingston",
                "Kirklees",
                "Knowsley",
                "Lake District",
                "Lambeth",
                "Lancashire",
                "Lancaster",
                "Leeds",
                "Leicester",
                "Leicestershire",
                "Lewes",
                "Lewisham",
                "Lichfield",
                "Lincoln",
                "Lincolnshire",
                "Lisburn and Castlereagh",
                "Liverpool",
                "Loch Lomond",
                "Luton",
                "Maldon",
                "Malvern Hills",
                "Manchester",
                "Mansfield",
                "Medway",
                "Melton",
                "Mendip",
                "Merthyr Tydfil",
                "Merton",
                "Mid Devon",
                "Mid East Antrim",
                "Mid Kent",
                "Mid Sussex",
                "Mid Ulster",
                "Middlesbrough",
                "Midlothian",
                "Milton Keynes",
                "Mole Valley",
                "Monmouthshire",
                "Moray",
                "NI Strategic Planning",
                "NSIP England",
                "NSIP Wales",
                "Neath",
                "New Forest (District)",
                "New Forest (Park)",
                "Newark and Sherwood",
                "Newcastle under Lyme",
                "Newcastle upon Tyne",
                "Newham",
                "Newport",
                "Newry Mourne Down",
                "Norfolk",
                "North Ayrshire",
                "North Devon",
                "North East Derbyshire",
                "North East Lincs",
                "North Hertfordshire",
                "North Kesteven",
                "North Lanarkshire",
                "North Lincs",
                "North Norfolk",
                "North Northamptonshire",
                "North Somerset",
                "North Tyneside",
                "North Warwickshire",
                "North West Leicestershire",
                "North York Moors",
                "North Yorkshire",
                "Northumberland (County)",
                "Northumberland (Park)",
                "Norwich",
                "Nottingham",
                "Nottinghamshire",
                "Nuneaton",
                "Oadby and Wigston",
                "Old Oak Park Royal",
                "Oldham",
                "Orkney",
                "Oxford",
                "Oxfordshire",
                "Peak District",
                "Pembroke Coast",
                "Pembrokeshire",
                "Pendle",
                "Perth",
                "Peterborough",
                "Plymouth",
                "Portsmouth",
                "Powys",
                "Preston",
                "Reading",
                "Redbridge",
                "Redcar and Cleveland",
                "Reigate",
                "Renfrewshire",
                "Rhondda",
                "Ribble Valley",
                "Richmond",
                "Richmondshire",
                "Rochdale",
                "Rochford",
                "Rossendale",
                "Rother",
                "Rotherham",
                "Rugby",
                "Runnymede",
                "Rushcliffe",
                "Rushmoor",
                "Rutland",
                "Ryedale",
                "Salford",
                "Sandwell",
                "Scarborough",
                "Scilly Isles",
                "Scottish Borders",
                "Sedgemoor",
                "Sefton",
                "Selby",
                "Sevenoaks",
                "Sheffield",
                "Shepway",
                "Shetlands",
                "Shropshire",
                "Slough",
                "Snowdonia",
                "Solihull",
                "Somerset",
                "South Ayrshire",
                "South Cambridgeshire",
                "South Derbyshire",
                "South Downs",
                "South Gloucestershire",
                "South Holland",
                "South Kesteven",
                "South Lanarkshire",
                "South Norfolk Broadland",
                "South Oxfordshire",
                "South Ribble",
                "South Somerset",
                "South Staffordshire",
                "South Tyneside",
                "South West Devon",
                "Southampton",
                "Southend",
                "Southwark",
                "Spelthorne",
                "St Albans",
                "St Helens",
                "Stafford",
                "Staffordshire",
                "Staffordshire Moorlands",
                "Stevenage",
                "Stirling",
                "Stockport",
                "Stockton-on-Tees",
                "Stoke on Trent",
                "Stratford on Avon",
                "Stroud",
                "Suffolk",
                "Sunderland",
                "Surrey",
                "Surrey Heath",
                "Sutton",
                "Swansea",
                "Swindon",
                "Tameside",
                "Tamworth",
                "Tandridge",
                "Taunton Deane",
                "Teignbridge",
                "Telford",
                "Tendring",
                "Test Valley",
                "Tewkesbury",
                "Thanet",
                "Three Rivers",
                "Thurrock",
                "Tonbridge",
                "Torbay",
                "Torfaen",
                "Torridge",
                "Tower Hamlets",
                "Trafford",
                "Tunbridge Wells",
                "Uttlesford",
                "Vale of White Horse",
                "Wakefield",
                "Walsall",
                "Waltham Forest",
                "Wandsworth",
                "Warrington",
                "Warwick",
                "Warwickshire",
                "Watford",
                "Waverley",
                "Wealden",
                "Welwyn Hatfield",
                "West Berkshire",
                "West Dunbartonshire",
                "West Lancashire",
                "West Lindsey",
                "West Lothian",
                "West Northamptonshire",
                "West Oxfordshire",
                "West Somerset",
                "West Suffolk",
                "West Sussex",
                "Western Isles",
                "Westminster",
                "Westmorland and Furness",
                "Wigan",
                "Wiltshire",
                "Winchester",
                "Windsor",
                "Wirral",
                "Woking",
                "Wokingham",
                "Wolverhampton",
                "Worcester",
                "Worcestershire",
                "Wrexham",
                "Wychavon",
                "Wyre",
                "Wyre Forest",
                "York",
                "Yorkshire Dales"
              ]
            }
          },
          "postcode": {
            "title": "Postcode (radius search)",
            "type": "string",
            "description": "UK postcode at the centre of a radius search, e.g. \"SW1A 1AA\". Needs \"Radius (km)\"."
          },
          "latitude": {
            "title": "Latitude (radius search)",
            "type": "string",
            "description": "Centre latitude for a radius search, e.g. \"51.5074\". Used instead of the postcode when set together with longitude."
          },
          "longitude": {
            "title": "Longitude (radius search)",
            "type": "string",
            "description": "Centre longitude for a radius search, e.g. \"-0.1278\"."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 0.05,
            "maximum": 50,
            "type": "number",
            "description": "Search radius around the postcode or point. Results come back nearest first.",
            "default": 2
          },
          "boundingBox": {
            "title": "Bounding box",
            "type": "string",
            "description": "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": {
            "title": "Exclude sub-area councils",
            "type": "boolean",
            "description": "For counties, regions and combined authorities: return only their own applications, not those of the district councils inside them.",
            "default": false
          },
          "keywords": {
            "title": "Keywords in description",
            "type": "string",
            "description": "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": {
            "title": "Applicant / agent company",
            "type": "string",
            "description": "Find applications where this text appears in the applicant or agent company name or address, e.g. \"Persimmon\"."
          },
          "appTypes": {
            "title": "Application types",
            "type": "array",
            "description": "Keep only these kinds of application.",
            "items": {
              "type": "string",
              "enum": [
                "Full",
                "Outline",
                "Amendment",
                "Conditions",
                "Heritage",
                "Trees",
                "Advertising",
                "Telecoms",
                "Other"
              ],
              "enumTitles": [
                "Full and householder",
                "Outline, scoping and prior approval",
                "Amendments",
                "Discharge of conditions",
                "Heritage and listed buildings",
                "Trees and hedges",
                "Advertising and signs",
                "Telecoms and masts",
                "Other"
              ]
            }
          },
          "appStates": {
            "title": "Decision status",
            "type": "array",
            "description": "Keep only applications with these decision outcomes.",
            "items": {
              "type": "string",
              "enum": [
                "Undecided",
                "Permitted",
                "Conditions",
                "Rejected",
                "Withdrawn",
                "Referred",
                "Unresolved",
                "Other"
              ],
              "enumTitles": [
                "Undecided (pending)",
                "Permitted",
                "Permitted with conditions",
                "Rejected",
                "Withdrawn",
                "Referred",
                "Unresolved",
                "Other"
              ]
            }
          },
          "appSizes": {
            "title": "Development size",
            "type": "array",
            "description": "Large = major schemes (40+ homes or 100+ documents), Medium = multi-dwelling or larger, Small = everything else.",
            "items": {
              "type": "string",
              "enum": [
                "Large",
                "Medium",
                "Small"
              ],
              "enumTitles": [
                "Large (major schemes)",
                "Medium",
                "Small"
              ]
            }
          },
          "receivedWithinDays": {
            "title": "Received within days",
            "minimum": 0,
            "type": "integer",
            "description": "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": {
            "title": "Received from",
            "type": "string",
            "description": "Earliest submission date (inclusive). When set, it replaces \"Received within days\"."
          },
          "receivedTo": {
            "title": "Received to",
            "type": "string",
            "description": "Latest submission date (inclusive). When set, it replaces \"Received within days\"."
          },
          "decidedWithinDays": {
            "title": "Decided within days",
            "minimum": 0,
            "type": "integer",
            "description": "Only applications decided in the last N days (0 = today). Ignored when a decided date range is set below."
          },
          "decidedFrom": {
            "title": "Decided from",
            "type": "string",
            "description": "Earliest decision date (inclusive). When set, it replaces \"Decided within days\"."
          },
          "decidedTo": {
            "title": "Decided to",
            "type": "string",
            "description": "Latest decision date (inclusive). When set, it replaces \"Decided within days\"."
          },
          "updatedWithinDays": {
            "title": "Updated within days",
            "minimum": 0,
            "type": "integer",
            "description": "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": {
            "title": "Sort by",
            "enum": [
              "default",
              "newest",
              "oldest",
              "recentlyDecided",
              "recentlyUpdated"
            ],
            "type": "string",
            "description": "Order of results. Radius searches default to nearest first.",
            "default": "default"
          },
          "applicationIds": {
            "title": "Application references",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "planit.org.uk URLs",
            "type": "array",
            "description": "Application pages (https://www.planit.org.uk/planapplic/...) or search URLs (https://www.planit.org.uk/api/applics/json?...).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of applications to return in total (0 = no limit).",
            "default": 200
          },
          "maxResultsPerAuthority": {
            "title": "Max results per council",
            "minimum": 0,
            "type": "integer",
            "description": "Cap per selected council so one busy council does not use the whole budget (0 = no cap).",
            "default": 0
          },
          "includeRawFields": {
            "title": "Include raw source fields",
            "type": "boolean",
            "description": "Add an \"otherFields\" object with every extra field the council register publishes.",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "Exclude empty fields",
            "type": "boolean",
            "description": "Omit null and empty fields from each record.",
            "default": false
          },
          "monitoringMode": {
            "title": "Monitoring mode (only new and updated)",
            "type": "boolean",
            "description": "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).",
            "default": false
          },
          "stateKey": {
            "title": "Monitoring state key",
            "type": "string",
            "description": "Name for the monitoring memory. Leave empty to derive it from your search. Use different keys for different watch lists."
          },
          "emitUnchanged": {
            "title": "Also output unchanged applications",
            "type": "boolean",
            "description": "In monitoring mode, output unchanged applications too (tagged UNCHANGED).",
            "default": false
          },
          "stateRetentionDays": {
            "title": "Forget applications after days",
            "minimum": 0,
            "type": "integer",
            "description": "Monitoring forgets applications not seen for this many days (0 = never).",
            "default": 180
          },
          "notifyOnlyChanges": {
            "title": "Notify only on changes",
            "type": "boolean",
            "description": "Send notifications only when there are new or updated applications.",
            "default": true
          },
          "notificationLimit": {
            "title": "Applications per notification",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum applications listed in one notification message.",
            "default": 10
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST the results as JSON to this URL after each run."
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Telegram bot token for notifications."
          },
          "telegramChatId": {
            "title": "Telegram chat ID",
            "type": "string",
            "description": "Telegram chat to notify."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "Discord channel webhook for notifications."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Slack incoming webhook for notifications."
          },
          "requestIntervalSecs": {
            "title": "Seconds between requests",
            "minimum": 60,
            "maximum": 600,
            "type": "integer",
            "description": "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.",
            "default": 60
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Not needed: the source is reached directly. Optional for very frequent schedules.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}