---
title: "Search News"
method: GET
path: "/google/news"
tags: ["Google News"]
---

# Search News

`GET /google/news`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/google/news`
- Auth: API key in header `X-API-KEY`

Search and scrape news articles from Google News.

## Query parameters

- `q` string
- `gl` string, nullable
- `hl` string, nullable
- `topic_token` string, nullable
- `kgmid` string, nullable
- `publication_token` string, nullable
- `section_token` string, nullable
- `story_token` string, nullable
- `so` integer, nullable
- `start` integer, nullable
- `page` integer, nullable

## Response `200`

- object
  - `news_results` object[], required
    - `position` integer, required
    - `title` string, required
    - `link` string, required
    - `type` string, required
    - `source` object
      - `name` string, required
      - `title` string, required
      - `icon` string
      - `authors` string[]
    - `authors` string[]
    - `date` string
    - `iso_date` string
    - `published_at` string
    - `thumbnail` string
    - `thumbnail_small` string
    - `snippet` string
    - `story_token` string
  - `menu_links` object[], required
    - `title` string, required
    - `link` string, required
    - `topic_token` string
  - `related_publications` object[], required
    - `title` string, required
    - `link` string, required
    - `publication_token` string
  - `sub_menu_links` object[], required
    - `title` string, required
    - `link` string, required
    - `topic_token` string
  - `highlight` object, nullable, required
    - `title` string, required
    - `link` string, required
    - `source` string
    - `date` string
    - `thumbnail` string
  - `related_topics` object[]
    - `title` string, required
    - `link` string, required
  - `related_searches` object[]
    - `position` integer, required
    - `query` string, required
    - `link` string, required
  - `stories` object[]
    - `title` string, required
    - `link` string, required
    - `articles` object[], required
      - `title` string, required
      - `link` string, required
      - `source` string, required
      - `date` string

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `402`: Your API key is valid, but the account has no free, subscription, or package credits available.
- `422`: Provide a query or exactly one supported Google News token, and keep pagination and locale parameters valid.
- `500`: The upstream service is temporarily unavailable. Please retry shortly.
- `503`: The upstream service is temporarily unavailable. Please retry shortly.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)