英国规划申请查询(PlanIt)
调用 PlanIt 公开免登录 JSON API,按规划机构、项目规模、审批状态、回溯天数、全文关键词、邮编半径与申请类型查询英国全域规划申请;输出地址、描述、决定日期、代理人公司/电话/地址、住宅套数、坐标、官方申请页与 PlanIt 详情页。数据源覆盖英格兰、苏格兰、威尔士与北爱尔兰 400+ 规划机构,无 API key、无登录。
概览
调用 PlanIt 的公开 JSON API(/api/applics/json)查询英国规划申请。无需 API key、无需登录、无需浏览器;数据源是 PlanIt 汇总的各地方规划机构公开数据。
输入
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
councils | string(每行/逗号) | 空=全国 | 规划机构名,如 Croydon、Tower Hamlets、Manchester;多机构按 60 秒间隔串行查询 |
appSize | string(每行/逗号) | Large,Medium | Large / Medium / Small;all 表示不限 |
appState | string(每行/逗号) | Permitted | Permitted / Undecided / Conditions / Rejected / Withdrawn / Referred / Unresolved / Other / Appeal;all 表示不限 |
daysBack | integer | 90 | 1-365;已决状态按决定日期,Undecided 按提交日期 |
searchText | string | 空 | PlanIt 全文检索,支持短语、OR、前缀减号排除 |
postcode | string | 空 | 半径搜索中心邮编,如 EC2A 4NE |
radiusKm | number | 10 | 1-100 公里,仅在填写邮编时生效 |
appTypes | string(每行/逗号) | 空 | 申请类型子串过滤,如 Full、Outline、Reserved |
maxResults | integer | 500 | 1-5000;每页 300 条,页间至少 60 秒 |
数组类输入用多行字符串或英文逗号分隔承载,以适配平台的基本类型字段。
输出
每条记录对应一个规划申请,以 planitId 去重。核心字段:council、address、postcode、description、appType、appSize、appState、decidedDate、startDate、agentCompany、agentTel、agentAddress、dwellings、latitude、longitude、portalUrl、planitUrl。
另附流程与扩展字段:reference、applicationType、status、decision、decidedBy、dateReceived、dateValidated、targetDecisionDate、applicantCompany、applicantAddress、easting、northing、distance、wardName、parish、nDocuments、nComments、docsUrl、commentUrl、mapUrl、sourceUrl、lastScraped、fetchedAt。
各机构差异化的其余字段统一放在 otherFieldsJson(JSON 文本),不丢源站扩展信息。
使用建议
- 首次先用单机构、
maxResults=10验证字段口径,再放大到全国或更多机构。 - 全国检索不填
councils,只调用一次 API;多机构每增加一家约多等 60 秒。 - 项目规模选
Large更适合开发/建材销售线索;Undecided适合跟踪 pipelines。 appTypes按子串匹配app_type、application_type与描述,因此Reserved等 PlanIt 非标准值也能过滤。
边界说明
- 仅使用 PlanIt 公开 API,不抓取各地方议会门户,不做联系人邮箱 enrichment。
- 源站对
applicant_name、agent_name、case_officer返回See source占位符,本应用不输出这些字段;真实姓名需打开portalUrl查看机构页面。 - PlanIt 限速:请求间隔 60 秒、每页最多 300 条、单次最多 5000 条/1000kB;HTTP 429 会按
Retry-After退避。 - 显式忽略运行环境的
HTTP_PROXY/HTTPS_PROXY/ALL_PROXY变量并直连 PlanIt;沙箱中这些变量可能指向无法解析的代理主机名,导致ConnectError: [Errno -5] No address associated with hostname。日志只记录变量名,不记录代理地址值。 - DNS/连接/超时等网络错误按 2/4/8/16/30 秒退避,最多重试 5 次;这类失败未到源站,不占用 60 秒请求额度。
- 邮编地理编码失败时按源站文档约定自动去掉半径过滤,并在日志中说明。
适用边界
仅使用 https://www.planit.org.uk/api/applics/json 官方公开接口,不抓取 381 个机构门户。严格遵循源站限速:每次 /api/applics 请求间隔至少 60 秒、尊重 429 Retry-After、每页最多 300 条、单次请求最多 5000 条/1000kB。arrays 输入用多行或逗号分隔字符串承载;appTypes 与未知状态值用客户端子串过滤。源站对申请人/代理人姓名、case officer 返回 'See source' 占位符,本应用不输出这些伪数据。
- 适合用于
- 建筑施工与建材销售:发现近期获批的大型开发项目并联系规划代理人
- 房地产投资:按邮编半径跟踪特定区域的住宅套数与审批趋势
- 规划顾问:对比不同机构的审批结果与决定周期
- 研究/新闻:按机构、状态、类型批量导出结构化规划数据
- 不要用于
- 需要申请人或代理人真实姓名——PlanIt 对这类字段返回占位符,须打开 portalUrl 人工查看机构门户
- 需要 2026 年以前的全量历史回填——单次请求受 5000 条与 60 秒限速约束
- 需要某个机构官方证明文件或法定 good-standing 类证明
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1未知规划机构返回 HTTP 400 时记录警告并跳过该机构,继续其余查询
- 2邮编地理编码失败或源站超时(400/Timeout)时按文档约定去掉半径过滤重试一次
- 3HTTP 429 按 Retry-After 或默认 65 秒退避,最多重试 3 次;仍失败则跳过该页
- 4单页 JSON 解析失败只影响该查询组,已获取记录仍然推送
- 5显式忽略运行环境代理变量并直连 PlanIt,避免沙箱代理 DNS 解析失败;日志只记录变量名不记录值
- 6DNS/连接/超时等网络错误按 2/4/8/16/30 秒退避,最多重试 5 次;未到源站的失败不占用 60 秒请求额度
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 规划机构(Council)
councils选填string每行一个或用英文逗号分隔的英国规划机构名,如 Croydon、Tower Hamlets、Manchester。留空=全国检索(PlanIt 单次 API 调用),多个机构之间会按源站要求间隔至少 60 秒 - 项目规模
appSize选填string每行一个或逗号分隔:Large(大型/10 套以上住宅或 1000 平米以上)、Medium(中型)、Small(小型/住户自建)。默认 Large,Medium;填 all 表示不限示例Large Medium - 审批状态
appState选填string每行一个或逗号分隔:Permitted、Undecided、Conditions、Rejected、Withdrawn、Referred、Unresolved、Other、Appeal。默认 Permitted;已决状态按决定日期回溯,Undecided 按提交日期回溯;填 all 表示不限示例Permitted - 回溯天数
daysBack选填integer从今天起向前查询的天数(1-365,默认 90)。已决状态按决定日期过滤,Undecided 按提交日期过滤范围1–365默认值90示例90 - 全文检索
searchText选填string检索描述、地址、编号、申请类型与决定文本。支持 PlanIt 语法:引号表示短语、or 表示或、前缀减号表示排除,如 "solar panel" or photovoltaic - 中心邮编
postcode选填string英国邮编作为半径搜索中心,如 EC2A 4NE、SW1A 1AA。需配合半径字段;源站地理编码失败时自动降级为无半径查询并在日志中说明 - 搜索半径(公里)
radiusKm选填number以中心邮编为圆点的搜索半径(1-100,默认 10)。仅在填写中心邮编时生效范围1–100默认值10示例10 - 申请类型关键词
appTypes选填string每行一个或逗号分隔,按子串匹配申请类型原文与描述,如 Full、Outline、Reserved、Hybrid、Demolition。留空=不限类型 - 最大结果数
maxResults选填integer最终返回记录上限(1-5000,默认 500)。PlanIt 每页最多 300 条且请求间隔至少 60 秒,因此每增加一页约多等 1 分钟范围1–5000默认值500示例500
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- PlanIt 唯一编号
planitIdstringPlanIt 全站唯一申请标识,用作去重键,如 Guildford/26/P/00754 - 规划机构
councilstring负责该申请的英国地方规划机构简称,如 Croydon - 申请编号
referencestring机构申请编号;源站 reference 为空时回退到 uid、altid 或 PlanIt 唯一编号 - 项目地址
addressstring申请地块或房产的完整地址
调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderByte/uk-planning-applications",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。