# Google News

## Overview

| Property | Value |
|----------|-------|
| **Status** | maintenance |
| **Method** | `GET` |
| **Endpoint** | `/v2/google/news` |
| **Base URL** | `https://api.autom.dev` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/google-news |

## Description

Extract real-time news articles from Google News with advanced filtering by topic, location, language, and pagination.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.autom.dev/register

## Example Request

```bash
curl --location --request GET 'https://api.autom.dev/v2/google/news' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search 'artificial intelligence news'. US/English

```json
{
  "pagination": {
    "next": 2,
    "current": 1,
    "other_pages": [
      2,
      3,
      4,
      5,
      6,
      7,
      8,
      9,
      10
    ],
    "has_next_page": true
  },
  "organic_results": [
    {
      "date": "3 hours ago",
      "link": "https://www.theguardian.com/technology/2026/mar/27/number-of-ai-chatbots-ignoring-human-instructions-increasing-study-says",
      "title": "Number of AI chatbots ignoring human instructions increasing, study says",
      "domain": "www.theguardian.com",
      "source": "The Guardian",
      "snippet": "Exclusive: Research finds sharp rise in models evading safeguards and destroying emails without permission.",
      "position": 1,
      "displayed_link": "www.theguardian.com",
      "snippet_matched": []
    },
    {
      "date": "20 hours ago",
      "link": "https://www.bloomberg.com/news/articles/2026-03-26/apple-plans-to-open-up-siri-to-rival-ai-assistants-beyond-chatgpt-in-ios-27",
      "title": "Apple Plans to Open Up Siri to Rival AI Assistants in iOS 27 Update",
      "domain": "www.bloomberg.com",
      "source": "Bloomberg.com",
      "snippet": "Apple Inc. plans to open Siri to outside artificial intelligence assistants, a major move aimed at bolstering the iPhone as an AI platform.",
      "position": 2,
      "displayed_link": "www.bloomberg.com",
      "snippet_matched": [
        "intelligence",
        "artificial"
      ]
    },
    {
      "date": "1 hour ago",
      "link": "https://www.cnbc.com/2026/03/27/anthropic-cybersecurity-stocks-ai-mythos.html",
      "title": "Cybersecurity stocks fall on report Anthropic is testing a powerful new model",
      "domain": "www.cnbc.com",
      "source": "CNBC",
      "snippet": "The cybersecurity sector has slumped this year on fears that new AI will massively disrupt their business models.",
      "position": 3,
      "displayed_link": "www.cnbc.com",
      "snippet_matched": []
    }
  ],
  "search_parameters": {
    "q": "artificial intelligence news",
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1,
    "uule": null,
    "engine": "google_news",
    "location": null
  }
}
```

### Search 'stock market': page 2

```json
{
  "pagination": {
    "next": 3,
    "current": 2,
    "other_pages": [
      1,
      3,
      4,
      5,
      6,
      7,
      8,
      9,
      10,
      11
    ],
    "has_next_page": true
  },
  "organic_results": [
    {
      "date": "3 hours ago",
      "link": "https://www.fool.com/investing/2026/03/27/stock-market-today-live-coverage/",
      "title": "Stock Market Today (LIVE): Nasdaq Enters Correction as Crude Tops $110",
      "domain": "www.fool.com",
      "source": "The Motley Fool",
      "snippet": "Top insights from the latest market news from Thursday, March 27.",
      "position": 1,
      "displayed_link": "www.fool.com",
      "snippet_matched": [
        "market"
      ]
    },
    {
      "date": "51 minutes ago",
      "link": "https://fortune.com/2026/03/27/trump-taco-iran-war-brent-crude-wti-nasdaq-stock-market-correction/",
      "title": "The big Stock market correction that Trump can't talk his way out of is official",
      "domain": "fortune.com",
      "source": "Fortune",
      "snippet": "TACO is over as the 10 year treasury yield spikes and the Nasdaq sinks over 10% from its peak.",
      "position": 2,
      "displayed_link": "fortune.com",
      "snippet_matched": []
    }
  ],
  "search_parameters": {
    "q": "stock market",
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 2,
    "uule": null,
    "engine": "google_news",
    "location": null
  }
}
```

## Documentation

## Overview
Scrape news results from Google News for any query. Returns structured news articles with publication date, title, source, snippet, and URL.

## Quickstart
```
POST https://api.piloterr.com/v2/google/news
Content-Type: application/json

{"query": "artificial intelligence news", "gl": "us", "hl": "en"}
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The news search query |
| `location` | string | no | City-level location |
| `gl` | string | no | 2-letter country code |
| `hl` | string | no | 2-letter language code |
| `page` | integer | no | Page number for pagination |
| `num` | integer | no | Results per page (default: 10) |

## Main use cases
- Monitor breaking news and press coverage for brand mentions in real time
- Build media intelligence dashboards aggregating news from multiple sources
- Track competitor press coverage and sentiment across regions
- Power news-based content recommendation engines