webflow-rate-limits

# Webflow Rate Limits ## Overview Handle Webflow Data API v2 rate limits using the SDK's built-in retry, manual backoff strategies, request queuing, and bulk endpoints to maximize throughput without hitting 429 errors. ## Prerequisites - `webflow-api` SDK installed - Understanding of async/await patterns - Knowledge of your site plan's rate limits ## Webflow Rate Limit Rules ### Per-Key Rate Limits Rate limits are applied **per API key** (not per site or per user). Each token has its own independent rate limit counter. | Rule | Details | |------|---------| | Scope | Per API key | | Reset window | 60 seconds (Retry-After header) | | CDN-cached requests | Do **not** count against rate limits | | Bulk endpoints | 1 request = 1 rate limit count (up to 100 items) | | Site publish | Max 1 successful publish per minute | | Webhook registrations | Max 75 per `triggerType` per site | ### Rate Limit Response Headers | Header | Description | |--------|-------------| | `X-RateLimit-Limit` | Max requests allowed in the window | | `X-RateLimit-Remaining` | Requests remaining in current window | | `Retry-After` | Seconds to wait before retrying (on 429) | ### 429 Response ```json { "code": "rate_limit", "message": "Rate limit exceeded. Please retry after 60 seconds." } ``` ## Instructions ### Step 1: SDK Built-In Retry The `webflow-api` SDK automatically retries 429 and 5xx errors with exponential backoff: ```typescript import { WebflowClient } from "webflow-api"; const...