Limits & fair use
GKit SheetsAPI limits — the per-request row cap, Google's quotas, and guidance for staying fast.
What's capped today
SheetsAPI runs on Cloudflare's edge in front of the Google Sheets API. While in beta there is no per-key request throttle, but two real limits apply:
- Row cap per list request: the
limitparameter is capped at 1000 rows. Useoffsetto paginate through larger sheets. - Google Sheets API quotas: requests ultimately hit Google's Sheets API, which enforces its own per-minute read/write quotas on your account.
Staying fast and within quota
- Cache reads in your app and refresh periodically rather than calling on every request.
- Batch writes —
POSTaccepts an array of rows in a single call. - Paginate large sheets with
limitandoffsetinstead of pulling everything. - Request only the fields you need with
fields=to shrink responses.
If you have a high-volume use case, get in touch — we're happy to help during beta.