API Rate Limits and Best Practices

Keep your BrainTube API integrations running smoothly.

Rate Limits

If you hit the limit, you receive a 429 response with a Retry-After header.

Best Practices

1. Cache Results — Don't re-fetch unchanged data. Cache for at least 5 minutes.
2. Use Appropriate Endpoints — Use search for quick lookups, graph-enhanced-search for deep results.
3. Batch Requests — Fetch multiple items in one query with a higher limit.
4. Handle Errors Gracefully — Implement retry logic with backoff for 429 responses.
5. Use Webhooks — Consider Supabase Realtime instead of polling.

Monitoring Usage

Track API usage from Settings. Each key shows last_used timestamp and total_requests count.

Need Higher Limits?

Contact support for custom rate limits for high-volume integrations.