Data Freshness and Caching Mechanism

To ensure maximum performance and respect YouTube API quotas, YTPulse employs an intelligent Data Caching Layer. This system balances the need for real-time accuracy with the technical constraints of large-scale data processing.

The 24-Hour Cache Cycle ($TTL$)

By default, channel data (including video stats, subscriber counts, and metadata) is stored in our database for 1440 minutes (24 hours).

During this window, any subsequent requests for the same channel will be served directly from our high-speed database cache ($D_{cache}$) rather than triggering a new request to the YouTube Data API ($A_{fetch}$).

$$Data_Source = \begin{cases} D_{\text{cache}} & \text{if } t_{\text{current}} - t_{\text{last sync}} < TTL \ A_{\text{fetch}} & \text{if } t_{\text{current}} - t_{\text{last sync}} \ge TTL \end{cases}$$

Why 24 Hours?

1. Consistency: YouTube statistics (like view counts and subscriber numbers) fluctuate constantly. A 24-hour cycle provides a stable "baseline" for a strategic audit, preventing minor hourly fluctuations from skewing the long-term Revenue Leak calculations.
2. API Optimization: Each audit requires dozens of API calls to fetch video details, thumbnails, and transcripts. Caching allows us to provide instant results for popular channels while staying within official Google quota limits.
3. Algorithmic Stability: Our AI analysis (DNA Mapping, Audience Matrix) requires a fixed snapshot of data to provide coherent strategic advice.

"Hard Refresh" and Report Expiry

• Preliminary Reports: These are tied to the 24-hour cache. If you run a new audit after 24 hours, the system will perform a "Hard Sync" to fetch the latest data points.
• Full Reports: Once a Full Strategic Report is generated, its data is "locked" to the moment of creation to ensure that the PDF and Dashboard views remain consistent throughout your recovery process.

Conclusion: Our caching mechanism ensures that you get the fastest possible results without sacrificing the strategic integrity of the audit. If you've made significant changes to your channel (e.g., updated all descriptions), we recommend waiting for the 24-hour cycle to complete before running a new diagnostic.