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 limit parameter is capped at 1000 rows. Use offset to 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 writesPOST accepts an array of rows in a single call.
  • Paginate large sheets with limit and offset instead 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.