Caching & versheid

Identieke queries worden gecachet zodat je niet de volle prijs betaalt (of wacht) voor een resultaat dat net is opgehaald. Of een verzoek uit de cache is geserveerd, wordt altijd gerapporteerd in stats.cached, en het bepaalt de kosten.

Cache-treffer vs. verse fetch

Bron	`stats.cached`	Credits	Latentie
Cache-treffer	`true`	3	sub-100ms
Verse fetch	`false`	6	live fetch via residentiële proxy

Een resultaat is cachebaar op basis van de exacte combinatie van query + land (gl) + taal (hl) + tijdfilter (tbs) + pagina — wijzig er één van en het is een andere cache-entry. Zie Prijzen & credits voor het creditmodel.

Versheid per verzoek regelen

Met de optionele freshness-parameter kies je hoe één enkel verzoek met de cache omgaat:

`freshness`	Gedrag
`default`	Serveer een recent gecachet resultaat als dat bestaat, anders haal vers op. (standaard)
`realtime`	Haal altijd vers op — omzeil de cache. Belast tegen het verse tarief (6 credits).
`cached`	Geef de voorkeur aan een gecachet resultaat.

{ "q": "nvidia stock price", "freshness": "realtime" }