메인 콘텐츠로 건너뛰기
GOOGLE_NEWS는 검색어에 대해 Google 검색의 뉴스 탭이 보여 주는 기사 목록을 반환합니다. 기사 10개 안팎이 담긴 페이지를 최대 10페이지까지 읽고 페이지를 넘어 Google의 순서를 유지하므로, 한 주제나 브랜드, 경쟁사에 대해 Google이 어느 언론사를 보여 주는지와 그 변화를 추적할 수 있습니다.

요청

아래 요청은 미국에서 전기차 관세를 검색할 때 뉴스 탭의 첫 두 페이지를 받습니다.
태스크는 비동기로 실행됩니다. 결과는 비동기 태스크에 설명한 방법으로 읽으세요.

파라미터

응답

예를 들어 위 요청은 다음과 같습니다.
pages에 이르기 전에 Google의 목록이 끝나면 newsResults에 Google이 보여 준 기사가 모두 담기고, pages는 읽은 페이지 수를 셉니다. position, title, link, page를 제외한 모든 필드를 선택 필드로 다루세요.

크레딧

읽은 뉴스 페이지마다 1크레딧입니다. 태스크가 시작될 때 요청한 페이지 수만큼 크레딧을 보류합니다. 기본값은 1, pages: 10은 10입니다. 완료되면 실제로 읽은 페이지 수만큼 과금하므로, Google의 목록이 3페이지에서 끝나면 3크레딧입니다. 실패한 태스크는 0크레딧입니다. 크레딧과 한도를 참고하세요.

제한과 오류

  • 완료된 태스크의 newsResults가 비어 있으면 Google이 그 검색어에 기사를 하나도 보여 주지 않았다는 뜻입니다. 반환하기 전에 다른 브라우저에서 한 번 더 확인하며, 1크레딧이 과금됩니다.
  • en, de, pt-BR 같은 언어 코드가 아닌 hl은 422 VALIDATION_ERROR를 반환합니다.
  • 1~10을 벗어난 pages나 desktop, mobile, android가 아닌 device는 422 VALIDATION_ERROR를 반환합니다.
  • state와 uule은 422 LOCATION_UNSUPPORTED를 반환합니다. 시장은 country로 지정하세요.
  • include.rawResponse는 효과가 없고, include.html과 include.analysis는 422를 반환합니다. Markdown과 원본 응답을 참고하세요.
  • 그 밖의 요청 오류는 오류에 정리되어 있습니다.

관련 문서