# Google News Top Headlines API

<p>Top headlines of Google News for a country and language, about 30 to 40 stories. Each item has position, title (publisher name removed), link, source (name and url), date (ISO 8601), guid and related_articles (the other articles of the same story). The channel block has the feed title, language, build time and topic token. Costs 1 credit. Failed requests cost nothing.</p>

- **Documentation:** [https://scrappa.co/docs/google-news-api/google_news_headlines](https://scrappa.co/docs/google-news-api/google_news_headlines)
- **API group:** Google News API
- **Endpoint:** `GET https://scrappa.co/api/google/news/headlines`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `hl` | string | No | Language of the feed, 2 letters, e.g. en, de, fr. Default: en. |
| `gl` | string | No | Country of the feed, 2 letters, e.g. us, de, gb. Default: us. |

## Example response

```json
{
    "channel": {
        "name": "Top stories",
        "title": "Top stories - Google News",
        "language": "en-US",
        "topic_token": null,
        "last_build_date": "2026-11-01T02:39:41+00:00"
    },
    "news_results": [
        {
            "date": "2026-11-01T02:29:35+00:00",
            "guid": "CBMidkFVX3lxTE9YR1owcUlLb3d1ajhFeWJacmU2aXAwV1g2Uk9aUjhtNFFNSlRSMXFxR2RCaWlIUWZ5M0w2M2kwODVndGNuSFdUangydkM0b0p5WERGOFY5QjZtSzNnYnhZTFd5NW1yZ2d6amJwMk9sdll6ZXdQeWc",
            "link": "https://news.google.com/rss/articles/CBMidkFVX3lxTE9YR1owcUlLb3d1ajhFeWJacmU2aXAwV1g2Uk9aUjhtNFFNSlRSMXFxR2RCaWlIUWZ5M0w2M2kwODVndGNuSFdUangydkM0b0p5WERGOFY5QjZtSzNnYnhZTFd5NW1yZ2d6amJwMk9sdll6ZXdQeWc?oc=5",
            "title": "2026 Elections Live Updates: Candidates Campaign in Battleground States on Final Weekend",
            "source": {
                "url": "https://www.nytimes.com",
                "name": "The New York Times"
            },
            "position": 1,
            "related_articles": [
                {
                    "link": "https://news.google.com/rss/articles/CBMijAFBVV95cUxOWmp6ZkYyZTFHVXB5NzhGaENaN2tQZXBlUWxKcG1aYVVMZ3dBOUJhZTNhdmNmVEk4dmFuVm1STFFNa05uZElRdGhYYUhxcVVLUDQtb1RfTDV2a0dmQlN2M2xVMGtOZ2c5eXYyWVdmSVNqV05TTTlGY0pIVDg5dnhaSDVjS0RwVkVNQU44aA?oc=5",
                    "title": "El-Sayed campaign wants Stevens to stay away after day of back-and-forth sniping",
                    "source": {
                        "name": "Politico"
                    }
                }
            ]
        },
        {
            "date": "2026-10-31T22:48:51+00:00",
            "guid": "CBMie0FVX3lxTE9uUFZpekxGX1haSlJXNUMzU29KaUF1WTFzQm9wMGk3TlVCQklydzFxakRnV2xSZkk2dkFIQTF3aTNKVjhnTFY5dG5CLVJNeHJfUGIxcHFXQ3VDT19rcTVwUk5sTGx6aHUxVzFKZ2xmX0dON2lELTlFNmZGNA",
            "link": "https://news.google.com/rss/articles/CBMie0FVX3lxTE9uUFZpekxGX1haSlJXNUMzU29KaUF1WTFzQm9wMGk3TlVCQklydzFxakRnV2xSZkk2dkFIQTF3aTNKVjhnTFY5dG5CLVJNeHJfUGIxcHFXQ3VDT19rcTVwUk5sTGx6aHUxVzFKZ2xmX0dON2lELTlFNmZGNA?oc=5",
            "title": "Virginia and D.C. sue to block construction of Trump arch",
            "source": {
                "url": "https://www.npr.org",
                "name": "NPR"
            },
            "position": 2,
            "related_articles": [
                {
                    "link": "https://news.google.com/rss/articles/CBMipwFBVV95cUxNTExNUU1ORVBtRDZ2N0R3R2J6OHpDS2tMbmNfOExQM2UwT3lBcUY5czZ4ZHFBZ2JnalNXb1B4MDlpUWM5eGR1ZlVVR1RGWWM2QXFmZUZrU0FIbmNrWUs4d1VSODQzeU80Q2lsUmE1cG5Cak1xTm5tdUZzSjRKNEVJdmFaN09GYmpBa0Mya0dwWXhRSm1ROVZ2T2hoMkZyM1FtUGFpcldXUQ?oc=5",
                    "title": "D.C. and Virginia sue to block Trump\u2019s proposed triumphal arch",
                    "source": {
                        "name": "The Washington Post"
                    }
                }
            ]
        }
    ],
    "search_parameters": {
        "gl": "US",
        "hl": "en-US",
        "ceid": "US:en",
        "engine": "google_news_headlines"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | Google News could not be reached or gave an unreadable answer. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)