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

> Google News API: search real-time Google News by keyword and get the top results as unified JSON — headline, source outlet, snippet, thumbnail, article URL, and UTC publish time, with the main ranking and Top Stories carousel merged into one list (a placement tag separates them). Filter by recency, localize by language and country, all for 1 credit per search. 100 free credits, no card.

TL;DR: SocialCrawl's Google News API exposes 1 endpoints, 1 credit per call, all returning one unified JSON schema with AI-enriched fields. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Search | GET | `/v1/google_news/search` | 1 | Search Google News |

## Code example

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

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## SocialCrawl vs NewsAPI.org

| Feature | SocialCrawl | NewsAPI.org |
| --- | --- | --- |
| Source | Live Google News SERP — what Google ranks right now | Its own crawled index of news publishers |
| Authentication | One x-api-key — sign up and call | API key, but free tier blocks production and recent articles |
| Response schema | Unified NewsArticleList JSON shared across every SocialCrawl platform | Its own article shape — separate from your other data sources |
| Localization | language_code + location_name / code / coordinate, non-Latin scripts verified | Language and country params, but smaller non-English coverage |
| Recency filter | time_range: hour, day, week, month, or year | from / to dates, with the recent window paywalled on free tier |
| Pricing | 1 credit per search, any depth; 100 free credits, no card | Free tier is dev-only; production needs a paid monthly plan |

## FAQ

### How do I search Google News with an API?

Send a GET request to /v1/google_news/search with a keyword. SocialCrawl returns the top Google News results as unified JSON — each with headline, source outlet, snippet, thumbnail, article URL, and absolute UTC publish time.

### What data does the Google News API return?

Each article includes title, source outlet, host domain, snippet, thumbnail, article URL, absolute UTC publish time, result rank, and a placement tag. It merges Google's main news ranking and the Top Stories carousel into one list.

### Can I filter Google News results by date?

Yes. Pass time_range set to hour, day, week, month, or year to return only articles published within that window. It maps to Google's recency operator internally, so you get fresh headlines on demand.

### Does the Google News API support other languages and countries?

Yes. Set language_code (e.g. ko) plus location_name, location_code, or location_coordinate to localize results. Non-Latin scripts like Korean and Japanese are supported — verified live.

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

Each search costs 1 credit on the standard tier, regardless of how many articles you request. New accounts get 100 free credits with no credit card required.

### What is the best Google News API?

SocialCrawl returns real-time Google News results — headlines, source, snippet, thumbnail, and absolute UTC publish time — for 1 credit per search, with date and locale filters and no proxies to maintain. 100 free credits start you off without a card.

### Is there a Google News data API?

Google's own public News API was deprecated years ago, so there is no official one for reading arbitrary Google News results. SocialCrawl provides a Google News data API in its place: GET /v1/google_news/search with a keyword returns the top headlines as unified JSON, each with source outlet, snippet, thumbnail, article URL, and absolute UTC publish time, filterable by recency and locale for 1 credit per search.

### Is there a Google News scraper API?

Yes, SocialCrawl's Google News endpoint is a scraper API without the scraping. GET /v1/google_news/search returns live results and merges Google's main news ranking and the Top Stories carousel into one list, separated by a placement tag. You skip proxy pools and CAPTCHA handling, filter by time_range and language, and pay 1 credit per search. New accounts get 100 free credits with no card.

## 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:

- What is the SocialCrawl Google News API?
- How to search Google News with an API in real time
- Compare SocialCrawl vs NewsAPI for real-time Google News data