logo

英国规划申请查询(PlanIt)

调用 PlanIt 公开免登录 JSON API,按规划机构、项目规模、审批状态、回溯天数、全文关键词、邮编半径与申请类型查询英国全域规划申请;输出地址、描述、决定日期、代理人公司/电话/地址、住宅套数、坐标、官方申请页与 PlanIt 详情页。数据源覆盖英格兰、苏格兰、威尔士与北爱尔兰 400+ 规划机构,无 API key、无登录。

发布者
价格
¥0.01 / 条
最近更新
2026-11-19

概览

调用 PlanIt 的公开 JSON API(/api/applics/json)查询英国规划申请。无需 API key、无需登录、无需浏览器;数据源是 PlanIt 汇总的各地方规划机构公开数据。

输入

字段类型默认说明
councilsstring(每行/逗号)空=全国规划机构名,如 Croydon、Tower Hamlets、Manchester;多机构按 60 秒间隔串行查询
appSizestring(每行/逗号)Large,MediumLarge / Medium / Small;all 表示不限
appStatestring(每行/逗号)PermittedPermitted / Undecided / Conditions / Rejected / Withdrawn / Referred / Unresolved / Other / Appeal;all 表示不限
daysBackinteger901-365;已决状态按决定日期,Undecided 按提交日期
searchTextstring空PlanIt 全文检索,支持短语、OR、前缀减号排除
postcodestring空半径搜索中心邮编,如 EC2A 4NE
radiusKmnumber101-100 公里,仅在填写邮编时生效
appTypesstring(每行/逗号)空申请类型子串过滤,如 Full、Outline、Reserved
maxResultsinteger5001-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. 1未知规划机构返回 HTTP 400 时记录警告并跳过该机构,继续其余查询
  2. 2邮编地理编码失败或源站超时(400/Timeout)时按文档约定去掉半径过滤重试一次
  3. 3HTTP 429 按 Retry-After 或默认 65 秒退避,最多重试 3 次;仍失败则跳过该页
  4. 4单页 JSON 解析失败只影响该查询组,已获取记录仍然推送
  5. 5显式忽略运行环境代理变量并直连 PlanIt,避免沙箱代理 DNS 解析失败;日志只记录变量名不记录值
  6. 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 唯一编号planitIdstring
    PlanIt 全站唯一申请标识,用作去重键,如 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 配置
{
  "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)。

价格

每条规划申请记录

按实际成功返回的数据条数计费,任务失败不计费。

¥0.01/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.01 / 条