A lightweight, production-ready weather proxy API built on Val Town. Powers the TabQuest browser extension.

Built on top of OpenWeatherMap with Redis-backed rate limiting and caching via Upstash.

• Current weather by city name
• IP-based rate limiting (10 requests/min per IP)
• 30-minute Redis cache per city — reduces OpenWeather API calls
• Clean error responses — no internal details leaked to clients
• CORS enabled — works from browser extensions and web clients

GET https://<your-val-town-username>-weatherapi.web.val.run?city=London

curl "https://your-username-weatherapi.web.val.run?city=Chennai"

{
  "coord": { "lon": 80.2785, "lat": 13.0878 },
  "weather": [{ "id": 801, "main": "Clouds", "description": "few clouds" }],
  "main": {
    "temp": 305.15,
    "feels_like": 309.22,
    "humidity": 70
  },
  "wind": { "speed": 5.14 },
  "name": "Chennai"
}

Note: Temperatures are returned in Kelvin by default (OpenWeatherMap standard). Unit conversion should be handled on the client side.

This API is designed to be self-hosted on Val Town. You'll need your own API keys.

Go to the Val Town project and click Remix.

Go to val.town/settings/environment-variables and add:

See docs/env-variables.md for detailed setup instructions.

Val Town deploys automatically on save. Your endpoint will be live at:

https://<your-username>-weatherapi.web.val.run

tabquest-weather-api/
├── src/
│   ├── config.ts       ← constants (rate limit, cache TTL, validation regex)
│   ├── env.ts          ← env var validation + types
│   ├── http.ts         ← CORS headers + JSON response helpers
│   ├── redis.ts        ← Redis client, rate limiting, caching
│   └── weather.ts      ← OpenWeather fetch + error mapping
├── main.ts             ← HTTP entry point
└── README.md

All tuneable values live in src/config.ts:

export const RATE_LIMIT = 10;          // requests per window per IP
export const RATE_WINDOW_SEC = 60;     // rate limit window in seconds
export const CACHE_TTL_SEC = 60 * 30;  // cache TTL (30 minutes)

This API powers TabQuest — an open source browser extension.

⭐ If you find this useful, consider starring the main repo.

tabquest/tabquest — The open source browser extension this API was built for.