Google News 헤드라인 검색 엔드포인트는 1개입니다. 키워드를 넣으면 NewsArticle 목록이 반환됩니다. 위치, 언어, time_range, publisher, from/to를 선택할 수 있습니다. 더 넓은 search/news 표면의 레그로도 사용됩니다. 데이터 API만 지원합니다.
/v1/google_news/search키워드 헤드라인을 반환합니다. title, url, source, published_at, 미디어가 포함될 수 있습니다. depth 기본값은 10이며 최대 100입니다. location_name, language_code, time_range, publisher, from, to로 범위를 좁힙니다.
keyword, depth, location_name, language_code, time_range, publisher, from, to
키워드와 맞는 Google 뉴스 결과를 돌려줍니다. 헤드라인과 매체명, 썸네일, 기사 URL, UTC 기준 정확한 발행 시각이 담깁니다.
국가와 언어, 기간, 특정 언론사 도메인으로 좁혀 가며 어떤 주제의 보도를 훑을 때 사용하세요.
1크레딧
keyword · Search query (e.g. 'openai'). Supports any language; pass the matching language_code. Advanced operators (site:, intitle:, cache:, …) are not supported.
$ curl https://www.socialcrawl.dev/v1/google_news/search?keyword=openai&depth=20&language_code=en&time_range=day&publisher=bbc.com&from=2026-07-01&to=2026-07-15 \
-H "x-api-key: sc_YOUR_API_KEY"// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Google News도 다른 SocialCrawl 엔드포인트와 같습니다. API 키로 GET /v1/google_news/search를 호출하고 캐시 미스에 1 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. Google News OAuth와 별도 SDK는 없습니다.
x-api-key 헤더에 키를 보냅니다. 퍼블리셔 포털 토큰은 필요 없습니다. Google SERP, Finance를 포함한 카탈로그 전 구간에 같은 키를 사용합니다.
라우트는 GET입니다. keyword와 선택적 depth, location_name 또는 location_code, language_code, time_range, publisher, from, to를 전달합니다. site: 같은 고급 연산자는 지원하지 않습니다. 과금 전에 검증합니다.
라이브 미스는 1 크레딧입니다. 캐시 히트는 0 크레딧이며 TTL은 약 5분입니다. 빈 응답과 하드 실패는 환불됩니다. 잘못된 파라미터는 400이며 과금하지 않습니다.
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. data.items에 NewsArticle 목록이 있습니다.
대부분 제품은 한 검색 형태를 쓰고 로케일이나 시간만 바꿉니다. 여러 국가 뉴스 팬아웃이 필요하면 컴포지트 search/news가 이 라우트를 레그로 재사용할 수 있습니다.
GET /v1/google_news/search?keyword=…&time_range=daykeyword와 depth에 맞는 NewsArticle items[]입니다.
기본 헤드라인 조회입니다. 기본 언어는 en, depth는 10입니다.
GET /v1/google_news/search?keyword=…&location_name=…location_name과 language_code로 범위가 잡힌 동일 형태입니다.
별도 제품 연동 없이 로컬 또는 비영어 뉴스를 가져옵니다.
GET /v1/search/news?query=…&countries=…시간 필터 결과, 또는 이 레그를 쓰는 search/news 팬아웃입니다.
최신성은 time_range 또는 from/to로 잡습니다. 더 넓은 뉴스 잡은 종량제 search/news를 호출합니다.
GET /v1/google_news/search
?keyword=federal+reserve
&time_range=day
&depth=20
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here{
"success": true,
"data": {
"items": [
{
"title": "Example headline",
"url": "https://news.example.com/…",
"source": "Example Outlet",
"published_at": "2026-08-03T12:00:00Z"
}
]
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}기사는 공유 NewsArticle 리프를 쓰므로 로케일과 컴포지트 레그에서도 파서가 같습니다.
items[]: title, url, source, published_at, 미디어 썸네일(있을 때)
동일 필드. location_name / language_code가 Google News SERP 범위를 바꿉니다.
동일 필드. time_range 또는 from/to가 게시 시각을 필터하고 publisher는 도메인 1곳으로 제한합니다.
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Google News 전용 사이드카가 아닙니다.
Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 분당 600회 한도와 키당 동시 50건을 적용합니다.
레지스트리에서 google_news/search를 찾습니다. 필수 keyword와 선택 필터 규칙이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 1 크레딧을 원자적으로 차감합니다.
platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다(약 5분). 미스면 Google News 기본 경로를 쓰고 정책이 허용하면 대체 경로로 폴백합니다. 빈 응답과 네트워크 오류는 예산 안에서 재시도합니다.
업스트림 JSON을 NewsArticle items로 매핑합니다. Zod로 검증한 뒤 성공 봉투로 감싸 빌링 감사에 남깁니다.
과금 규칙
Google News는 공개 읽기 뉴스 SERP입니다. 헤드라인을 NewsArticle로 정규화하므로 두 번째 뉴스 SDK를 코드에 넣을 필요가 없습니다.
로케일, 언어, 시간 창, 선택적 퍼블리셔 필터가 있는 키워드 뉴스 검색을 제공합니다. 헤드라인과 링크 읽기 전용입니다. 전체 기사 본문 스크레이프가 아니며 Google Alerts 관리도 아닙니다.
기본 경로는 Google News 전용 연동입니다. 전용 필터가 없을 때는 대체 경로로 자동 전환됩니다. depth 기반 단일 페이지이며 cursor 페이지네이션은 없습니다.
success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 헤드라인은 title, url, source, published_at을 가진 NewsArticle 행이 됩니다.
site: 또는 intitle: 연산자는 없습니다. 이 라우트에서 전체 기사 본문 추출은 없습니다. 쓰기 엔드포인트는 없습니다. 다중 국가 팬아웃은 search/news에 있으며 이 표면을 레그로 재사용합니다.
이 API가 가장 많이 사용되는 작업입니다.
브랜드·토픽 뉴스 모니터링
호출은 keyword와 time_range 또는 language_code에 집중됩니다. 한 쿼리로 여러 국가가 필요하면 컴포지트 search/news가 사용됩니다. 다중 로케일 파라미터와 약 5분 캐시를 가진 고정 1 크레딧 뉴스 검색입니다. SERP·파이낸스와 같은 키를 사용합니다. 별도 뉴스 벤더 계약은 필요 없습니다.
라이브 미스는 보통 수 초입니다. 빈 재시도와 폴백은 희소 쿼리에서 라우트 예산까지 길어질 수 있습니다.
Google News 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
브랜드 키워드와 time_range=day로 search를 폴링합니다. 새 매체 URL이 나타나면 알립니다. 조용한 시간대는 캐시 히트로 비용을 낮춥니다.
language_code와 location_name으로 로케일 패스를 돌립니다. title, source, published_at을 시트나 웨어하우스에 적재합니다.
한 시장은 google_news/search를 직접 쓰고, 여러 국가는 종량제 search/news를 호출합니다. 같은 SocialCrawl 키를 사용합니다.
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
같은 Google News 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | NewsAPI.org |
|---|---|---|
| 데이터 출처 | 현재 구글 뉴스 결과 스냅샷이며 같은 요청은 최대 5분 캐시돼요 | 자체적으로 수집한 뉴스 매체 색인이에요 |
| 인증 | x-api-key 하나로 가입하자마자 호출하면 돼요 | API 키는 있지만 무료 플랜은 운영 환경과 최신 기사를 막아요 |
| 응답 스키마 | 모든 SocialCrawl 플랫폼과 같은 통합 NewsArticleList JSON으로 와요 | 자체 기사 포맷이라 다른 데이터 소스와 따로 놀아요 |
| 현지화 | language_code와 location_name / code / coordinate, 비라틴 문자까지 확인했어요 | 언어·국가 파라미터는 있지만 비영어 커버리지가 좁아요 |
| 최신 필터 | time_range로 시간·일·주·월·연 단위를 받아요 | from / to 날짜는 되지만 최근 기간은 무료 플랜에서 막혀요 |
| 요금 | 검색 한 번 1 크레딧, 깊이 무관, 신용카드 없이 100 크레딧 무료예요 | 무료 플랜은 개발용뿐이고 운영하려면 유료 월 구독이 필요해요 |
데이터 출처
인증
응답 스키마
현지화
최신 필터
요금
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기AI에게 SocialCrawl을 물어보세요