Lo que devuelve
Todos los códigos postales actuales del Reino Unido, desde datos abiertos de la Oficina Nacional de Estadísticas y Ordnance Survey.
Código postal, latitud/longitud, coordenadas este/norte, país, región, distrito, condado, barrio, parroquia, circunscripción parlamentaria, áreas de NHS y policía, LSOA/MSOA, índice de desigualdad y códigos de la ONS. Los códigos postales inválidos y finalizados se marcan y no se cobran.
Usos comunes
Formularios de dirección, zonas de entrega, localizadores de tiendas, limpieza de CRM, análisis de propiedades y demográfico. Pago por código postal.
Solicitud
POST https://api.pushbuild.com/uk-postcodes/run con un cuerpo JSON. Envíe su clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
postcodes | lista de cadenas | Códigos postales completos del Reino Unido, con cualquier espacio o mayúscula. |
coordinates | lista de cadenas | Puntos "lat,lon"; devuelve los códigos postales más cercanos. |
autocomplete | lista de cadenas | Códigos postales parciales, p. ej. SW1A 1. |
outcodes | lista de cadenas | Distritos postales, p. ej. SW1A, M1. |
radiusMeters | entero | Radio de búsqueda para coordenadas (máx. 2000). Por defecto: 1000. |
maxResultsPerPoint | entero | Códigos postales por coordenada o autocompletar (máx. 100). Por defecto: 10. |
autocompleteDetails | boolean | Devolver registros completos en lugar de cadenas de código postal. Por defecto: true. |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
Ejemplo
curl -X POST https://api.pushbuild.com/uk-postcodes/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"postcodes": ["SW1A 1AA", "M1 1AE"], "maxItems": 20}'Respuesta
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Cada llamada devuelve hasta 500 elementos. Los registros que no pasan la validación o no se encuentran se marcan en los elementos y no se cobran.
Precios
Pague solo por los resultados devueltos: $0,16 por 1.000 códigos postales. Sin cargo por errores o búsquedas vacías.
Úselo desde Claude, ChatGPT o Cursor
Esta API también es un servidor MCP: https://api.pushbuild.com/mcp/uk-postcodes. Agréguelo a cualquier asistente que soporte servidores MCP remotos, con su clave en el encabezado X-API-Key. Mismos precios. Configuración para cada aplicación.
Díganos qué necesitan construir.
Preguntas sobre esta API, volúmenes más altos, o una fuente de datos que necesiten que aún no cubrimos.
hello@pushbuild.com