# Google News Topic Headlines API

<p>Headlines of one Google News topic. Send topic (WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH) or a topic_token, 50 to 80 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). Costs 1 credit. Failed requests cost nothing.</p>

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

## 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 |
| --- | --- | --- | --- |
| `topic` | string | No | One of WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH. Send this or topic_token. |
| `topic_token` | string | No | Google News topic token. Tokens are tied to a language and country. Send this or topic. |
| `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": "World - Latest",
        "title": "World - Latest - Google News",
        "language": "en-US",
        "topic_token": "CAAqKggKIiRDQkFTRlFvSUwyMHZNRGx1YlY4U0JXVnVMVlZUR2dKVlV5Z0FQAQ",
        "last_build_date": "2026-11-01T02:39:51+00:00"
    },
    "news_results": [
        {
            "date": "2026-10-31T21:00:33+00:00",
            "guid": "CBMihgFBVV95cUxPLVpZYzZlRmU2d3VWb1JHXzd4MThSUlRfVmt1NzVPVWhEWEcwOFN2dU9oT1hSMkFodG90UEdkdFNldU45Tkx0Q3c4N1U5U0kzWmpPRExqcEltempmN2hLUXZXUmJITHdvOVRQQU4xazFzVlp5MnZxeTRMYUVIek5aNi1pSWktUQ",
            "link": "https://news.google.com/rss/articles/CBMihgFBVV95cUxPLVpZYzZlRmU2d3VWb1JHXzd4MThSUlRfVmt1NzVPVWhEWEcwOFN2dU9oT1hSMkFodG90UEdkdFNldU45Tkx0Q3c4N1U5U0kzWmpPRExqcEltempmN2hLUXZXUmJITHdvOVRQQU4xazFzVlp5MnZxeTRMYUVIek5aNi1pSWktUQ?oc=5",
            "title": "Hundreds of Thousands Join Another Round of Protests in France",
            "source": {
                "url": "https://www.nytimes.com",
                "name": "The New York Times"
            },
            "position": 1,
            "related_articles": [
                {
                    "link": "https://news.google.com/rss/articles/CBMipAFBVV95cUxQdGZ3VDBMUUphN0oxbExCLXh4eUdKSG5tMTVXMUN6bDVuN0pWSkFVUTFYN2Z2Qm9jcTh3OVFmVWR1ZzZXMHVXUjV2LXdqUndkc2piSDlNTHRTTzRRYzc4V0VyVmUtbTNadFdjMDhHSHRvclBIdlRENUp1VnBRTXhiSjRNMy1xZFFrRWJRTktCWEVIazd1aTV6eXRQelVKQnk1TUpmTw?oc=5",
                    "title": "A third weekend of protests in France as youth-led rallies sweep Europe",
                    "source": {
                        "name": "AP News"
                    }
                }
            ]
        },
        {
            "date": "2026-10-31T22:43:00+00:00",
            "guid": "CBMiuwFBVV95cUxQN2tCSVYwNXlmVktrRkpCNWM3UVVoRzVUWlhtVElmUllrbWlhZjIxcXV3MUNDTmVEM1lQLU9qWWtOOWNOaC1BYmN5RTdNMDY2dzJ0STYzNG1mQy1FS3ltbnliY0lKREtiVWNMWVN4NnJtYzlnek5qUFZfbFlSbzNXWUJHRjliVF9tbG51d0x0NjJuQlRpNjVzSWNFdXBLY0xqOTN4Ymo1LWRhV3ZqOFBuWGhaM0U1aVdXOVVz",
            "link": "https://news.google.com/rss/articles/CBMiuwFBVV95cUxQN2tCSVYwNXlmVktrRkpCNWM3UVVoRzVUWlhtVElmUllrbWlhZjIxcXV3MUNDTmVEM1lQLU9qWWtOOWNOaC1BYmN5RTdNMDY2dzJ0STYzNG1mQy1FS3ltbnliY0lKREtiVWNMWVN4NnJtYzlnek5qUFZfbFlSbzNXWUJHRjliVF9tbG51d0x0NjJuQlRpNjVzSWNFdXBLY0xqOTN4Ymo1LWRhV3ZqOFBuWGhaM0U1aVdXOVVz?oc=5",
            "title": "Tusk defends overhaul of Poland\u2019s constitutional court despite protests",
            "source": {
                "url": "https://www.theguardian.com",
                "name": "The Guardian"
            },
            "position": 2,
            "related_articles": [
                {
                    "link": "https://news.google.com/rss/articles/CBMiiwFBVV95cUxNTWJWOGNNazR6Y2dTQVZ4T2xqOVhNdG5FWV9vTTVISVROeFpULVlqZHp5Y0xMc1pUcThCNGFjY2lJaHZPTGVzeUJCckxwMnYzazhDc010Wi0yNHFSVmlOZmZXOS1TVDNoVWhpMzhHdV9zSEJ0R01uSlZ3akNBa285elYtNC14VVlzQTl3?oc=5",
                    "title": "Tensions over Poland\u2019s top court ignite as the country\u2019s prime minister and president square off",
                    "source": {
                        "name": "CNN"
                    }
                }
            ]
        }
    ],
    "search_parameters": {
        "gl": "US",
        "hl": "en-US",
        "ceid": "US:en",
        "topic": "WORLD",
        "engine": "google_news_topic"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The topic token does not exist for this language and country. 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)