Por padrão, uma API de Busca do Google devolve sempre os mesmos resultados perenes. Quando você está acompanhando notícias, tendências ou temas de última hora, quer apenas páginas recentes — e é exatamente isso que o filtro de tempo tbs faz. Ele reproduz o menu Ferramentas → Última hora / dia / semana da interface do Google.
O parâmetro tbs
Adicione tbs ao corpo da requisição com um valor qdr (query date range):
| Valor | Janela |
|---|---|
qdr:h | Última hora |
qdr:d | Último dia |
qdr:w | Última semana |
curl -X POST https://api.serp.cheap/v1/search \
-H "X-API-Key: $SERP_CHEAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"openai announcement","gl":"us","tbs":"qdr:d"}'Isso retorna apenas páginas que o Google indexou no último dia — sem artigos perenes e antigos abafando as notícias.
Um monitor de notícias em poucas linhas
Faça polling em intervalos regulares e você tem um sistema de alertas leve. Aqui está em Python:
import requests, time
def recent(query, window="qdr:h"):
r = requests.post(
"https://api.serp.cheap/v1/search",
headers={"X-API-Key": KEY},
json={"q": query, "gl": "us", "tbs": window},
)
return r.json().get("organic", [])
seen = set()
while True:
for hit in recent('"your brand"'):
if hit["link"] not in seen:
seen.add(hit["link"])
print("NEW:", hit["title"], hit["link"])
time.sleep(600) # a cada 10 minutosTroque qdr:h por qdr:d/qdr:w para alargar a janela. Essa é a espinha dorsal do monitoramento de marca e concorrentes.
Para que serve
- Monitoramento de notícias e PR — capture menções dentro da hora.
- Detecção de tendências — alimente um agente de pesquisa de IA com resultados frescos para que ele raciocine sobre o que está acontecendo agora.
- SEO de conteúdo fresco — veja quem está ranqueando para um tema nesta semana, não quem ranqueava anos atrás.
- Mudanças de preço e produto — combine com monitoramento de preços para detectar novas ofertas rapidamente.
Combine com outros parâmetros
O tbs se acumula com todo o resto — país, idioma, paginação:
-d '{"q":"élections","gl":"fr","hl":"fr","tbs":"qdr:w","page":1}'Isso é resultados recentes franceses, em francês. Veja a referência completa de parâmetros e SEO local por país.
A seguir
- Parâmetros da API de Busca do Google explicados
- Monitoramento de SERP de concorrentes
- API de Busca do Google para agentes de IA
Experimente o serp.cheap
Comece a puxar resultados frescos e filtrados por data hoje. 100 buscas grátis no cadastro — sem cartão; depois pague conforme o uso a partir de $0,75/1k, e os créditos permanecem válidos por 12 meses.
- Obtenha sua chave de API grátis →
- Prefere pagar com cartão? O serp.cheap também está no RapidAPI (
$0,90/1k) e no Apify ($1,50/1k).