Docs

Rate limits

GeoQ uses flat daily lookup quotas, not per-query metering. When you hit your quota you're rate-limited with a 429 — you are never billed an overage.

Quotas by plan

Quotas reset at 00:00 UTC. Only successful (200) lookups count toward your quota.

Rate-limit headers

Every response includes headers so you can track usage:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 814
X-RateLimit-Reset: 1736899200   # unix epoch (UTC midnight)

The 429 response

{
  "error": {
    "type": "rate_limited",
    "message": "Daily lookup quota exceeded.",
    "reset": 1736899200
  }
}

Handling limits

• Cache repeated lookups of the same IP in your app — you control that.
• Back off until X-RateLimit-Reset on a 429.
• Need more headroom? Upgrade your plan — still flat, still no overage.