Polish Address & Postal Code API

Power checkout forms, CRM & logistics apps in Poland. Autocomplete streets & cities, lookup postal codes (PNA), drill-down TERYT hierarchy — built on official GUS data.

原始信息汇总

数据集名称

Polish Address & Postal Code API

数据集概述

这是一个专为开发者设计的波兰地址和邮政编码API，基于官方GUS TERYT登记数据（TERC、SIMC、ULIC）和Spis PNA邮政编码分配表构建，提供可靠、结构化的地址参考数据和邮政编码查询服务。

核心优势

• 官方数据源：来源于GUS TERYT登记数据，非网页抓取。
• 功能丰富：支持自动补全、层级选择器和TERYT地址解析，超越基本的邮政编码API。
• 生产级JSON响应：采用一致的{data, meta}响应格式，遵循OpenAPI 3.1规范，错误码可预测。
• AI助手MCP支持：每个REST端点均可作为MCP工具使用，适用于Cursor、Claude等大语言模型客户端。
• 免费套餐：提供免费层，无需承诺即可开始集成。

关键功能与端点

功能	端点组
统一自动补全（城市+街道）	/v1/autocomplete/unified
按邮政编码、城市、区、街道查询	/v1/postal-codes/*、/v1/cities/*
级联区域选择器（省→县→乡→地点→街道）	/v1/regions/*
通过TERYT代码解析完整地址	/v1/addresses/resolve
AI代理的MCP工具	支持lookup_by_zip、autocomplete_unified等

MCP（模型上下文协议）

API已作为MCP服务器公开，语言模型可自主查询波兰地址和邮政编码。每个REST端点映射一个MCP工具，连接网关为https://mcp.rapidapi.com，需使用x-api-host: polish-address-postal-code-api.p.rapidapi.com和x-api-key进行认证。

可用工具列表：autocomplete_unified、autocomplete_localities、autocomplete_streets、autocomplete_postal、lookup_by_zip、lookup_by_city、lookup_by_city_district、lookup_by_city_street、resolve_address、resolve_by_path、list_provinces、list_counties、list_communes、list_localities、list_districts、list_streets。

适用场景

• 电子商务结账地址表单
• CRM/ERP地址录入
• 物流与配送区域验证
• 需要TERYT标识符的政府及合规应用

不包含的内容

本API提供地址参考数据和邮政编码分配，不提供GPS坐标或全球地理编码服务。

文档与资源

• 实时OpenAPI规范：https://api.addresses-lookup.grynienko.com/docs
• 带有示例的落地页：https://addresses-lookup.grynienko.com