Caching and freshness

Every response carries meta.cached, true when the answer came from our cache, and meta.fetched_at, when the data was actually read from the platform. A cached answer is never presented as new: its fetched_at is the original time.

A cached answer costs the same credits as a fetched one. You pay for the answer, not for how we produced it, so the price of a call never depends on who asked before you.

The same call with the same parameters is answered from the cache until its window ends. After that the answer is deleted, not just refreshed: we don’t keep what you asked for beyond it (see Privacy).

Add fresh=true to skip the cache and read the platform now. It costs the endpoint’s usual credits, and the new answer replaces the cached one for everyone after you.