Free tier
Search endpoints (/v1/search/rentals, /v1/search/sales), areas (/v1/areas), market routes, and the photo proxy (/v1/photos/{key}) work without an API key and use the Free tier limits of 10 requests/minute and 100 requests/month per IP. The public /v1/health endpoint is also available without authentication, but it is outside Borough’s metered quota and rate-limit middleware.
Paid plans
All paid tiers include automatic data freshness on property and building detail: when cached data is past your tier’s threshold, the API returns it immediately with
"source": "stale" and queues a background refresh, so your next request gets fresher data. Search is different: search results are kept current by the scheduled crawl, so "source": "stale" on a search response is a freshness signal only and does not queue a refresh. Check the response’s source and dataAge to see how fresh a given result is, and see Data freshness for the per-tier thresholds.
Overage billing
When you exceed your included monthly quota, requests continue to flow instead of being blocked immediately. Each additional request is billed at the overage rate for your tier, up to the monthly overage cap. How it works:- Your included quota is consumed first (no overage charges)
- Once the base quota is exhausted, each additional request incurs the overage rate
- The hard limit is your base quota plus the maximum extra requests before hitting the dollar cap
- Example: Starter gets 5,000 included + 10,000 overage (0.005) = 15,000 total
- Once the hard limit is reached, requests return
429 QUOTA_EXCEEDED - Free anonymous quotas reset on the 1st of each calendar month
- Paid quotas and overage counters reset with your Polar subscription billing period
X-Quota-* response headers on every request. Paid tiers also receive X-Quota-Overage-Limit showing the hard limit.
Overage charges are billed automatically through Polar.sh at the end of each billing period.
Subscribe
Click below to choose your plan and complete checkout. YourBOROUGH-<uuid> license key is delivered immediately.
Get API Key
After subscribing, your license key will be emailed to you and you’ll be redirected to the quickstart guide to make your first request.