klaviyo-performance-tuning

# Klaviyo Performance Tuning ## Overview Optimize Klaviyo API performance with response caching, request batching, cursor-based pagination, sparse fieldsets, and connection pooling. ## Prerequisites - `klaviyo-api` SDK installed - Understanding of Klaviyo's rate limits (75 req/s burst, 700 req/min) - Redis or in-memory cache (optional) ## Klaviyo API Performance Characteristics | Operation | Typical Latency | Max Page Size | |-----------|----------------|---------------| | Get Profile by ID | 50-150ms | N/A | | Get Profiles (list) | 100-300ms | 20 (default), 100 (some endpoints) | | Create Profile | 100-200ms | N/A | | Create Event | 50-100ms | N/A | | Get Segment Profiles | 200-500ms | 20 | | Campaign Operations | 200-500ms | 20 | ## Instructions ### Step 1: Sparse Fieldsets (Reduce Payload Size) Klaviyo supports JSON:API sparse fieldsets -- request only the fields you need. ```typescript // BAD: Fetches all profile fields (20+ attributes) const profiles = await profilesApi.getProfiles(); // GOOD: Only fetch email and firstName (much smaller payload) const profiles = await profilesApi.getProfiles({ fieldsProfile: ['email', 'first_name', 'created'], }); // Note: fieldsProfile uses snake_case field names (API-level names) // Fetch profiles with included list relationships const profilesWithLists = await profilesApi.getProfiles({ fieldsProfile: ['email', 'first_name'], include: ['lists'], fieldsLists: ['name'], }); ``` ### Step 2: Response Caching ```types...