Storyblok · Rate Limits
Storyblok Rate Limits
Storyblok publishes per-second rate limits on the Content Delivery API that vary by request type. Cached CDN requests get the highest ceiling (1,000 RPS); uncached single content entries and small listings allow 50 RPS, with limits scaling down as listing page size grows. Limits are per token/space. Beyond steady-state limits the API returns HTTP 429 and clients are expected to back off.
6 Limits
Throttle: 429
CMSContent DeliveryHeadless CMSREST APIRate Limiting
Limits
Cached CDN Requests token
1000
Cached responses served from the CDN.
Single Content Entry token
50
Single uncached content entry retrieval.
Listings up to 25 Entries token
50
List endpoints returning 25 or fewer entries per page.
Listings 25-50 Entries token
15
Listings 50-75 Entries token
10
Listings 75-100 Entries token
6
Per-second cap is reduced proportionally as page size increases beyond 25 entries.
Policies
Throttling Response
When the rate limit is exceeded the API returns HTTP 429; clients should pause and retry with backoff.
Caching
Storyblok recommends prioritizing cached requests, which have a 20x higher per-second ceiling than uncached single-entry requests.
Exponential Backoff
Use exponential backoff with jitter on retry to avoid synchronized retry storms.
Plan Quotas
Beyond per-second limits, monthly API request totals are bound by the subscribed plan (100k Starter, 1M Growth, 4M Growth Plus); overages above plan caps are billed at $10 per 1M extra requests.