기본적으로 Google Search API는 매번 동일한 상시(evergreen) 결과를 반환합니다. 뉴스, 트렌드, 속보 주제를 추적할 때는 최신 페이지만 필요한데, 바로 그 일을 tbs 시간 필터가 해줍니다. Google UI의 도구 → 지난 1시간 / 하루 / 일주일 메뉴를 그대로 반영합니다.
tbs 매개변수
요청 본문에 qdr(query date range) 값과 함께 tbs를 추가하세요:
| 값 | 범위 |
|---|---|
qdr:h | 지난 1시간 |
qdr:d | 지난 하루 |
qdr:w | 지난 일주일 |
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"}'이렇게 하면 Google이 지난 하루 동안 색인한 페이지만 반환됩니다 — 오래된 상시 기사가 뉴스를 밀어내지 않습니다.
몇 줄로 만드는 뉴스 모니터
주기적으로 폴링하면 가벼운 알림 시스템이 됩니다. 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) # every 10 minutesqdr:h를 qdr:d/qdr:w로 바꾸면 범위를 넓힐 수 있습니다. 이것이 브랜드 및 경쟁사 모니터링의 근간입니다.
어디에 유용한가
- 뉴스 & PR 모니터링 — 언급을 한 시간 이내에 포착.
- 트렌드 탐지 — 최신 결과를 AI 리서치 에이전트에 공급하여 지금 일어나는 일을 추론하게 하세요.
- 최신 콘텐츠 SEO — 몇 년 전이 아니라 이번 주 특정 주제로 누가 랭크되는지 확인.
- 가격 & 상품 변화 — 가격 모니터링과 결합해 새 목록을 빠르게 포착.
다른 매개변수와 결합
tbs는 국가, 언어, 페이지네이션 등 다른 모든 것과 함께 사용할 수 있습니다:
-d '{"q":"élections","gl":"fr","hl":"fr","tbs":"qdr:w","page":1}'이렇게 하면 프랑스어로 된 최신 프랑스 결과가 됩니다. 전체 매개변수 레퍼런스와 국가별 로컬 SEO를 참고하세요.
다음
serp.cheap 사용해 보기
오늘 바로 최신 시간 필터링 결과를 가져오기 시작하세요. 가입 시 무료 검색 100회 — 카드가 필요 없습니다. 이후에는 $0.75/1k부터 사용한 만큼 지불하며, 크레딧은 12개월간 유효합니다.
- 무료 API 키 받기 →
- 카드로 결제하는 것이 편하신가요? serp.cheap은 RapidAPI(
$0.90/1k)와 Apify($1.50/1k)에서도 이용할 수 있습니다.