Google News Scraper

Google News Topics

Retrieve the list of available Google News topic categories for a given country. Use the returned token values when creating a task with feed: "topic" and by: "token".

Note: This endpoint returns only the topics shown in the Google News topbar menu for the given country (e.g. Top stories, Business, Technology, Sports) — not every possible topic on the platform. To scrape any other topic, use feed: "topic" with by: "kgmid" or provide a topicToken obtained from a previous result's relatedTopics.

Endpoint

GET /api/parsing/v1/google-news-topics/{gl}

Path Parameters

Name	Type	Required	Description
gl	string	yes	Country code (e.g. `US`, `GB`, `DE`)

Example Request

curl https://app.scrapering.com/api/parsing/v1/google-news-topics/US \
  --header 'Authorization: Bearer YOUR_API_KEY'

Example Response

[
  {
    "id": "02a9ebcb-cfaf-4b61-b25f-f14136e5fa3c",
    "rank": 0,
    "hl": "en-US",
    "gl": "us",
    "title": "Top stories",
    "token": "CAAqJggKIiBDQkFTRWdvSUwyMHZNRFZxYUdjU0FtVnVHZ0pWVXlnQVAB",
    "url": "https://news.google.com/topics/CAAqJggKIiBDQkFTRWdvSUwyMHZNRFZxYUdjU0FtVnVHZ0pWVXlnQVAB?hl=en-US&gl=US&ceid=US%3Aen",
    "fetchedAt": "2026-09-02T07:42:04.741Z",
    "createdAt": "2026-09-02T07:42:11.479Z"
  },
  {
    "id": "7b902f22-6732-4b4c-8b2a-05f24351dfc6",
    "rank": 4,
    "hl": "en-US",
    "gl": "us",
    "title": "Business",
    "token": "CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx6TVdZU0FtVnVHZ0pWVXlnQVAB",
    "url": "https://news.google.com/topics/CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx6TVdZU0FtVnVHZ0pWVXlnQVAB?hl=en-US&gl=US&ceid=US%3Aen",
    "fetchedAt": "2026-09-02T07:42:04.741Z",
    "createdAt": "2026-09-02T07:42:11.479Z"
  }
]

Response Fields

Field	Type	Description
id	string	Internal record ID
rank	number	Display order on the Google News homepage (0-based)
gl	string	Country code this topic belongs to
hl	string	Language/locale code (e.g. `en-US`)
title	string	Human-readable topic name (e.g. `Business`, `Technology`)
token	string	Topic token — pass as `topicToken` when creating a task
url	string	Direct Google News URL for this topic
fetchedAt	string	ISO 8601 timestamp of when the topics list was last fetched
createdAt	string	ISO 8601 timestamp of when this record was stored

Next steps

Creating a task — use token values with feed: "topic" and by: "token"