Performance7 min read

Caching Best Practices

When to trust our cache, when to bypass.

Default TTLs

Read endpoints have sensible defaults: 5min for SERP, 1hr for IP geo, 24hr for company data. Cached responses include X-Cache: HIT and don't count against rate limits as harshly.

Bypassing cache

Add ?no_cache=1 to force a fresh upstream call. Use sparingly — frequent bypasses defeat the point of caching and slow your app down.

Custom TTLs on Pro+

Pro and higher can set per-request TTL via ?ttl=<seconds>, between 60 and 86400. Useful for high-freshness use cases like SEO rank tracking.