# Google News Search API (https://www.socialcrawl.dev/platforms/google_news/search)

> Returns a unified NewsArticleList of the top Google News results for a keyword, right now — headline, source outlet, snippet, thumbnail, article URL, and absolute UTC publish time. Combines Google's main news ranking and the Top Stories carousel into one list (`placement` distinguishes them). Localize with `location_name`/`location_code`/`location_coordinate` + `language_code` (non-Latin scripts supported). Filter by recency with `time_range`. There is no pagination beyond `depth` — Google News exposes at most 200 articles per query (default 10, max 100 on this surface). For the full article body, scrape the returned `url`. Sourced live from DataForSEO's Google News SERP — an ordinary synchronous request (~1-3s).

TL;DR: `GET /v1/google_news/search` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keyword` | yes | Search query (e.g. 'openai'). Supports any language; pass the matching language_code. Advanced operators (site:, intitle:, cache:, …) are not supported. |
| `depth` | no | Number of articles to retrieve (default 10, multiples of 10, max 100). No pagination beyond depth. |
| `location_code` | no | Google location code (e.g. 2840 = United States). Use one of location_code / location_name / location_coordinate. |
| `location_name` | no | Google location name (e.g. 'South Korea'). |
| `location_coordinate` | no | GPS target as 'latitude,longitude,radius_mm' (e.g. '40.7128,-74.0060,200') for local-news radius queries. |
| `language_code` | no | Google language code (e.g. 'en', 'ko'). Default 'en'. |
| `time_range` | no | Only return articles published within this window: hour, day, week, month, or year. (hour \| day \| week \| month \| year) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/google_news/search?keyword=openai" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Google News results with an API?

Send a GET request to /v1/google_news/search with the keyword parameter (e.g. openai). SocialCrawl returns the top news articles as unified JSON — headline, source, snippet, thumbnail, article URL, and absolute UTC publish time.

### What fields does the Google News Search API return?

Each article carries title, source outlet (or host domain), domain, snippet, thumbnail image_url, article url, published_at (absolute UTC), rank, and a placement tag of news_search or top_stories so you can tell the main ranking from the Top Stories carousel.

### How do I filter Google News by recency?

Pass time_range as hour, day, week, month, or year to return only articles from that window — verified live to return sub-60-minute articles for time_range=hour. It maps to Google's tbs=qdr recency operator.

### Can I control how many news articles come back?

Use depth (default 10, multiples of 10, max 100). Google News exposes at most 200 articles per query with no cursor, so there is no pagination beyond depth — depth simply widens the single result page.

### How much does the Google News Search API cost?

Each search is a flat 1 credit on the standard tier, no matter the depth. New accounts get 100 free credits with no credit card required, so you can test it before paying anything.

See the full Google News API: https://www.socialcrawl.dev/platforms/google_news

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to search Google News by keyword using the SocialCrawl API
- What does the SocialCrawl Google News Search API return?