Cache & frescor

Consultas idênticas são armazenadas em cache para que você não pague o preço cheio (nem espere) por um resultado que acabou de ser buscado. Se uma requisição foi servida do cache é sempre informado em stats.cached, e isso determina o custo.

Acerto de cache vs. busca nova

Origem	stats.cached	Créditos	Latência
Acerto de cache	true	3	menos de 100ms
Busca nova	false	6	busca ao vivo via proxy residencial

Um resultado é cacheável pela combinação exata de consulta + país (gl) + idioma (hl) + filtro de tempo (tbs) + página — mude qualquer um deles e será uma entrada de cache diferente. Veja Preços & créditos para o modelo de créditos.

Controlando o frescor por requisição

O parâmetro opcional freshness permite escolher como uma única requisição trata o cache:

freshness	Comportamento
default	Serve um resultado recente do cache, se existir; caso contrário, busca novo. (padrão)
realtime	Sempre busca novo — ignora o cache. Cobrado à tarifa de busca nova (6 créditos).
cached	Prefere um resultado do cache.

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

Quando forçar realtime

Use realtime para consultas que mudam rápido, em que um cache de alguns minutos é inaceitável (cotações de ações, notícias de última hora, placares ao vivo). Para todo o resto, default lhe dá economia de cache automaticamente.

Disponibilidade

freshness é aceito pela API hoje; a aplicação de realtime por requisição está sendo implantada. Até lá, o cache é automático e stats.cached sempre reflete o que de fato aconteceu.