Lo que devuelve
Datos oficiales del Servicio Nacional de Clima para cualquier ubicación de EE.UU., como JSON limpio.
- Pronóstico de 7 días: períodos de día y noche con temperatura, probabilidad de precipitación, viento y pronóstico textual.
- Pronóstico horario: hasta 156 horas.
- Condiciones actuales: última lectura de la estación más cercana (temperatura, humedad, viento, presión, visibilidad).
- Alertas activas: avisos, alertas y consejos con gravedad, horario e instrucciones.
Solicitud
POST https://api.pushbuild.com/us-weather/run con un cuerpo JSON. Envíe su clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
locations requerido | lista de cadenas | Códigos ZIP de EE.UU., "Ciudad, ST" o "lat,lon". |
forecast | boolean | Períodos de día y noche para los próximos 7 días. Por defecto: true. |
hourly | boolean | Pronóstico hora a hora. Por defecto: false. |
hourlyHours | entero | ¿Cuántas horas devolver (máximo 156)? Por defecto: 48. |
current | boolean | Última observación de la estación meteorológica más cercana. Por defecto: true. |
alerts | boolean | Avisos, alertas y consejos activos en la ubicación. Por defecto: true. |
units | cadena: us, metric | Unidades para los pronósticos. Las condiciones actuales siempre son métricas. Por defecto: "us". |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
Ejemplo
curl -X POST https://api.pushbuild.com/us-weather/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"locations": ["10001", "Austin, TX", "47.6062,-122.3321"], "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: $1,60 por 1.000 ubicaciones. 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/us-weather. 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