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

> Search current Google News results by keyword and receive unified JSON with headline, source, snippet, thumbnail, article URL, and UTC publish time. Exact repeats may use the 5-minute cache and cost 0 credits; Cache-Control: no-cache requests a billed refresh. Filter by recency and locale for 1 credit on a cache miss.

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 | Current Google News snapshot: exact repeats may use the 5-minute cache | 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 in production.

### 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 a current Google News snapshot (headlines, source, snippet, thumbnail, and absolute UTC publish time) for 1 credit on a cache miss. Exact repeats within 5 minutes cost 0 credits; send Cache-Control: no-cache to request a billed refresh.

### 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 a current results snapshot and merges Google's main news ranking and the Top Stories carousel into one list, separated by a placement tag. Exact repeats may use the 5-minute cache and cost 0 credits; Cache-Control: no-cache requests a billed refresh.

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