Name: Google News API: Search News by Keyword and Country
Brand: s-r
SKU: api-s-r-google-news
Availability: InStock
Author: API Market

# Google News API

## Overview

The Google News API searches Google News for a keyword in a chosen country and language and returns the articles as JSON. Each row is one article with its headline, link, publisher, publication date, snippet and position in the results.

It is built for brand monitoring, media intelligence, newsletters and AI tools that need current headlines on a topic. Pick the country and language edition, limit the results to a recent window such as the last 24 hours, and get up to 100 articles per call.

## Features

*   **2 endpoints**: the same search as `POST /run` with a JSON body or `GET /run` with query parameters.
*   **Country and language**: `gl` and `hl` choose the edition, such as `US` and `en`.
*   **Recency filter**: `when` limits results to a window such as `24h` or `7d`.
*   **Up to 100 articles**: set with `limit`.
*   **Sort**: newest or oldest first.
*   **Rate limit**: 10 requests per second on Free and Basic, 20 on Pro, 50 on Plus.

## Use Cases

*   **Brand monitoring**: track news that mentions a company or product.
*   **News alerts**: send new headlines on a topic to Slack or email.
*   **Newsletters**: collect the week's coverage of a market.
*   **AI agents**: give an assistant current headlines on a query.

## API Documentation

### Base URL

All requests go through the API.market proxy at this base URL:

```
https://prod.api.market/api/v1/s-r/google-news
```

### Authentication

Every request must include your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Search news (POST)

Returns Google News articles for the query in the JSON body.

**Method:** `POST`

**Endpoint:** `/run`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| q | body | What to search for on Google News. Sent as the RSS feed's q parameter; when a recency filter is set it is appended to this same string as when:<value>, so the two share one query. | string | Yes | - | - |
| hl | body | Two-letter ISO language code for article language and UI (e.g. en, nl, de, fr). Sent as hl, used for the Accept-Language header, and it is the right-hand half of the edition code whenever that is derived rather than overridden. | string | No | en | - |
| gl | body | Two-letter ISO country code (e.g. US, NL, GB, DE). Sent uppercased as gl and forms the left-hand half of the edition code whenever that is derived rather than overridden. | string | No | US | - |
| ceid | body | Country:language edition code, used exactly as typed but only when it contains a colon; anything else is ignored and the edition is rebuilt from gl and hl as GL:hl. Country and language are still sent as their own gl and hl parameters either way, so this overrides the edition alone, not them. | string | No | - | - |
| sort | body | Order of the articles you get back. Oldest first reverses the articles already fetched under the limit; it does not ask Google for the oldest coverage on the topic. One of `newest`, `oldest` | string | No | newest | - |
| when | body | Limit results to a recent window. Format: Nh / Nd / Ny (e.g. 24h, 7d, 1y). Nm is read as N months and sent as N*30 days, because Google's when: operator has no month unit and answers one with an empty feed. Every row reports the window actually used as when_effective. Leave blank for no filter. | string | No | - | - |
| limit | body | Maximum articles to return (1-100). The RSS feed returns at most ~100 items per query and has no pagination, so 100 is a ceiling rather than a choice. | integer | No | 10 | 100 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/s-r/google-news/run' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "q": "openai"
}'
```

**Example Response (200 OK):**

```json
{
  "data": {
    "items": [
      {
        "rank": 1,
        "title": "OpenAI kicks off charm offensive to change voters' view of data centers - Reuters",
        "url": "https://news.google.com/rss/articles/CBMirgFBVV95cUxNT3pvX1VfZi1WbVpNTl9weHZ0YUJ5RmhvVTgyOVRadlVyc01HeW1rdm5uRjhzMFRSSkJ4TW1yVmxHbkFvSnpTWkxWSGRIalRXM0dndmdtUXNTNTlYc0V2TGlxNTEtZm5iZDJlZXd5VUhjWUc1ejFXeTJpNHBzY2g4NllDX3dNWmo0eFBZQW1MUVR5Z2N...",
        "source": "Reuters",
        "published": "Thu, 05 Nov 2026 19:34:01 GMT",
        "snippet": "OpenAI kicks off charm offensive to change voters' view of data centers    Reuters OpenAI pledges to halt NDAs in new data center policy proposal after election rebuke    CNBC OpenAI Pledges to Give Locals More Say in Data Center Projects...",
        "thumbnail": null,
        "query": "openai",
        "hl": "en",
        "gl": "US",
        "ceid": "US:en",
        "sort": "newest",
        "when": null,
        "when_effective": null,
        "fetched_in_seconds": 2.86,
        "fetched_at": "2026-11-05T21:01:00.371Z",
        "published_at": "2026-11-05T19:34:01.000Z",
        "engine": "google_news",
        "position": 1,
        "publisher": "Reuters",
        "country": "US",
        "language": "en"
      },
      {
        "rank": 2,
        "title": "OpenAI Had ‘Rough’ First Half of Year Before Coding Takeoff, Brockman Says - WSJ",
        "url": "https://news.google.com/rss/articles/CBMiqAFBVV95cUxPN1BMSVo0V0RrUEQxRDNFN25fZE5ya3hZbnRSMFFZSUFOOUpvMXEtUjFUZWVsQmtrakd5QmpsX1dFaEVYdUZ6aXRxRGgzWTZRcEVxWXRuVy0xUWl3X1YwZDVPRGctQ20tMndTN1lfSVNuME8wRFhwQnJZLWRqMi1DZmFzZVZmdGZ3UkhQQzQxbFd6c2R...",
        "source": "WSJ",
        "published": "Thu, 05 Nov 2026 04:00:00 GMT",
        "snippet": "OpenAI Had ‘Rough’ First Half of Year Before Coding Takeoff, Brockman Says    WSJ",
        "thumbnail": null,
        "query": "openai",
        "hl": "en",
        "gl": "US",
        "ceid": "US:en",
        "sort": "newest",
        "when": null,
        "when_effective": null,
        "fetched_in_seconds": 2.86,
        "fetched_at": "2026-11-05T21:01:00.371Z",
        "published_at": "2026-11-05T04:00:00.000Z",
        "engine": "google_news",
        "position": 2,
        "publisher": "WSJ",
        "country": "US",
        "language": "en"
      }
    ]
  },
  "meta": {
    "request_id": "34ef96e6-3db4-4e20-84b6-aaa628db04ee",
    "duration_ms": 2863,
    "units": 10,
    "cached": false
  }
}
```

#### 2. Search news (GET)

The same search with query parameters.

**Method:** `GET`

**Endpoint:** `/run`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| q | query | What to search for on Google News. Sent as the RSS feed's q parameter; when a recency filter is set it is appended to this same string as when:<value>, so the two share one query. | string | Yes | - | - |
| hl | query | Two-letter ISO language code for article language and UI (e.g. en, nl, de, fr). Sent as hl, used for the Accept-Language header, and it is the right-hand half of the edition code whenever that is derived rather than overridden. | string | No | en | - |
| gl | query | Two-letter ISO country code (e.g. US, NL, GB, DE). Sent uppercased as gl and forms the left-hand half of the edition code whenever that is derived rather than overridden. | string | No | US | - |
| ceid | query | Country:language edition code, used exactly as typed but only when it contains a colon; anything else is ignored and the edition is rebuilt from gl and hl as GL:hl. Country and language are still sent as their own gl and hl parameters either way, so this overrides the edition alone, not them. | string | No | - | - |
| sort | query | Order of the articles you get back. Oldest first reverses the articles already fetched under the limit; it does not ask Google for the oldest coverage on the topic. One of `newest`, `oldest` | string | No | newest | - |
| when | query | Limit results to a recent window. Format: Nh / Nd / Ny (e.g. 24h, 7d, 1y). Nm is read as N months and sent as N*30 days, because Google's when: operator has no month unit and answers one with an empty feed. Every row reports the window actually used as when_effective. Leave blank for no filter. | string | No | - | - |
| limit | query | Maximum articles to return (1-100). The RSS feed returns at most ~100 items per query and has no pagination, so 100 is a ceiling rather than a choice. | integer | No | 10 | 100 |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/s-r/google-news/run?q=bitcoin&hl=en&gl=US&limit=3' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "data": {
    "items": [
      {
        "rank": 1,
        "title": "Bitcoin Price Crashes Over 5% to $75,000 as Tech Rout Wipes Out Leveraged Longs - Bitcoin Magazine",
        "url": "https://news.google.com/rss/articles/CBMifEFVX3lxTFBMd0tTamdoNnlfUVRTSHFac1UyUWtGWHdBRENkR3hEVE1Rb3lXOWdocFR6Sk1EdU5CbjJvU0wzanBkVTVvZlpMTHBCRkZNRGlZd0YtSzJHVHE4SldHS1F6ejdURVJnVlNqU3VRenZ6Smc0d01tcGU3MXdiNnY?oc=5",
        "source": "Bitcoin Magazine",
        "published": "Thu, 05 Nov 2026 15:48:18 GMT",
        "snippet": "Bitcoin Price Crashes Over 5% to $75,000 as Tech Rout Wipes Out Leveraged Longs    Bitcoin Magazine",
        "thumbnail": null,
        "query": "bitcoin",
        "hl": "en",
        "gl": "US",
        "ceid": "US:en",
        "sort": "newest",
        "when": null,
        "when_effective": null,
        "fetched_in_seconds": 3.6,
        "fetched_at": "2026-11-05T21:01:05.932Z",
        "published_at": "2026-11-05T15:48:18.000Z",
        "engine": "google_news",
        "position": 1,
        "publisher": "Bitcoin Magazine",
        "country": "US",
        "language": "en"
      },
      {
        "rank": 2,
        "title": "Trump Media moves $342 million in bitcoin to Crypto.com, blockchain data show - CoinDesk",
        "url": "https://news.google.com/rss/articles/CBMivwFBVV95cUxOd2JhaWVYSkpWdGxJcWdZS2U2UnJuOXNRNGFQa0M2ZGV1c0E1RmtUaktXZHg4R28xVGNobkV1YkZMLUVuXzk3QTd0LWxHaE1ZeFpmVUx2dmtIUlRDUDN4cl95V2RlOWgxX0p2WUE1d2NkQjZ0WWZlcFQ1M1pvQnBtMVZoMklQWFdXemtYaDNReG5KWER...",
        "source": "CoinDesk",
        "published": "Thu, 05 Nov 2026 04:11:00 GMT",
        "snippet": "Trump Media moves $342 million in bitcoin to Crypto.com, blockchain data show    CoinDesk",
        "thumbnail": null,
        "query": "bitcoin",
        "hl": "en",
        "gl": "US",
        "ceid": "US:en",
        "sort": "newest",
        "when": null,
        "when_effective": null,
        "fetched_in_seconds": 3.6,
        "fetched_at": "2026-11-05T21:01:05.932Z",
        "published_at": "2026-11-05T04:11:00.000Z",
        "engine": "google_news",
        "position": 2,
        "publisher": "CoinDesk",
        "country": "US",
        "language": "en"
      }
    ]
  },
  "meta": {
    "request_id": "bca923d9-d185-4775-9a0e-8d2396b01037",
    "duration_ms": 3604,
    "units": 3,
    "cached": false
  }
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the response body holds the result. |
| 400 | Bad Request | A required parameter is missing or a value is invalid. Check the parameter table for the endpoint. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key is valid but your subscription does not allow this request, for example an endpoint outside your plan. |
| 404 | Not Found | The path does not exist, or the resource you asked for was not found. |
| 429 | Too Many Requests | You sent more than your plan's requests per second (10 on Free and Basic, 20 on Pro, 50 on Plus). Slow down and retry, honouring the `Retry-After` header. |
| 500 | Internal Server Error | Something went wrong while processing the request. Retry after a short wait. |
| 503 | Service Unavailable | The service or its upstream data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

The Free and Basic plans allow up to 10 requests per second, Pro allows 20 and Plus allows 50. Each plan also has a monthly call quota shown on the pricing page. Going over your plan's per-second limit returns `429 Too Many Requests`. Throttle your client to stay under it, back off and retry when you get a 429, and honour the `Retry-After` header when it is present.

## FAQ

*   **Why are the article links on news.google.com?**

    Google News returns its own redirect links. Opening one goes to the publisher's article.

*   **Can I get older articles?**

    The feed returns recent coverage. `sort=oldest` reverses the articles already fetched, it does not reach older coverage.

*   **How do I choose the edition?**

    Set `gl` to the country and `hl` to the language, for example `NL` and `nl` for the Dutch edition.

*   **How many results does the Free plan return?**

    Free plans return at most 10 results per call. Paid plans return the full result set up to the endpoint's limit.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Search Google News by keyword, country and language and get headlines, links, publishers, dates and snippets as JSON.