SerpBase

Google News Search — API 레퍼런스

POST
사용 가능
/google/news/search

뉴스 검색

주제나 키워드로 Google 뉴스를 검색합니다. 기사와 발행자 필드는 원본 결과에 따라 다릅니다.

type
news
result
news
과금
1 credits

주제나 키워드로 Google 뉴스를 검색합니다. 기사와 발행자 필드는 원본 결과에 따라 다릅니다.

파라미터
q
필수
string

필수

검색 쿼리 문자열입니다.

hl
선택
string

선택

언어 코드입니다. 기본값은 en입니다.

gl
선택
string

선택

국가 코드입니다. 기본값은 us입니다.

page
선택
number

선택

1부터 시작하는 페이지 번호입니다. 기본값은 1입니다.

query
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "semiconductor supply"

json
{
  "query": "semiconductor supply"
}
Playground에서 실행
응답 필드
query
필수
string

필수

요청에서 정규화된 쿼리입니다.

page
필수
number

필수

현재 페이지 번호입니다. 1부터 시작합니다.

news
선택
NewsResult[]

뉴스 결과가 파싱된 경우.

Google 뉴스 결과.

NewsResult 결과 항목 구조
rank
필수
number

필수

이 응답 안에서 1부터 시작하는 순위입니다.

position
선택
number

제공되는 경우 rank의 별칭입니다.

position 필드를 기대하는 클라이언트용 정규화 순위입니다.

title
필수
string

필수

결과 제목입니다.

link
필수
string

필수

파서가 반환하는 기본 링크입니다.

url
선택
string

결과 링크를 정규화할 수 있을 때 반환됩니다.

정규화된 대상 URL이며 보통 link와 같습니다.

source_url
선택
string

Google 리다이렉트/원본 URL이 관측된 경우에만 반환됩니다.

디버깅과 출처 확인을 위해 보존되는 원본 Google URL입니다.

display_url
선택
string

Google 표시 텍스트나 도메인을 추출할 수 있을 때 반환됩니다.

표시 URL 또는 출처 도메인입니다.

source
선택
string

발행자 텍스트가 파싱된 경우.

발행자/출처 라벨.

time
선택
string

Google이 시간 텍스트를 제공하는 경우.

게시 시간 원문.

published_at
선택
string

파싱된 시간이 있으면 해당 별칭.

정규화된 게시 시간 별칭.

snippet
선택
string

스니펫이 파싱된 경우.

기사 요약 스니펫.

thumbnail_url
선택
string

Google이 썸네일을 제공할 때 반환됩니다.

썸네일 URL입니다.

thumbnail
선택
string

제공되는 경우 thumbnail_url의 별칭입니다.

정규화된 썸네일 별칭입니다.

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/news/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"semiconductor supply"}'
기존 Google 요청 예시
bash
curl -X POST https://api.serpbase.dev/google/news/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "apple event",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
참고

브랜드 모니터링, 트렌드 추적, 미디어 탐색.

출처와 시간은 Google 메타데이터 텍스트에서 파싱하므로 모두 선택 필드로 처리하세요.