Skip to content

About

Google News API by Autom: Google News articles as structured JSON. Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby examples.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Google News API by Autom

Google News API

Discord Get API key API docs License: MIT

The Autom Google News API returns Google News articles — title, source, date, link — as structured JSON.

  • Google News API — Search Google News via API and retrieve structured news results with pagination.

Use it for media monitoring, PR tracking, news aggregation or market intelligence.

Endpoint Request Credits
Google News API GET /v1/google/news 1

Table of contents

How it works

  1. Create a Autom account and copy your API key from the dashboard.
  2. Call https://api.autom.dev with the header x-api-key: YOUR_API_KEY.
  3. Use the result in your app — no infrastructure to run.
export AUTOM_API_KEY="your-api-key"
pip install requests        # Python
# TypeScript: Node.js 18+ (native fetch), run with `npx tsx file.ts`

Google News API

Search Google News via API and retrieve structured news results with pagination.

GET https://api.autom.dev/v1/google/news · 1 credit per request · API reference

Request parameters

Parameter In Type Required Description
query query string ✅ Query to search on Google News (keywords, company, topic).
page query number — Page number for pagination (1 = first page).
num query number — Maximum number of results per page (e.g. 10).
gl query string — Country to use (two-letter country code, e.g. us, fr).
hl query string — Language to use (two-letter language code, e.g. en, fr).

Python example

import os

import requests

API_KEY = os.environ["AUTOM_API_KEY"]
HEADERS = {"x-api-key": API_KEY}

response = requests.get(
    "https://api.autom.dev/v1/google/news",
    headers=HEADERS,
    params={
        "query": "coffee",
    },
    timeout=120,
)
response.raise_for_status()

data = response.json()
print(data)

TypeScript example

type GoogleNewsApi = {
  pagination?: {
    next?: number;
    current?: number;
    has_next_page?: boolean;
  };
  organic_results?: {
    date?: string;
    link?: string;
    title?: string;
    domain?: string;
    source?: string;
    snippet?: string;
    position?: number;
  }[];
  search_parameters?: {
    q?: string;
    gl?: string;
    hl?: string;
    page?: number;
    engine?: string;
  };
};

const headers = { "x-api-key": process.env.AUTOM_API_KEY!, "Content-Type": "application/json" };

const params = new URLSearchParams({
  "query": "coffee",
});

const response = await fetch(`https://api.autom.dev/v1/google/news?${params}`, { headers });
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);

const data = (await response.json()) as GoogleNewsApi;
console.log(data);

Output example

Example response from the API reference, abridged.

{
  "pagination": {
    "next": 2,
    "current": 1,
    "has_next_page": true
  },
  "organic_results": [
    {
      "date": "1 day ago",
      "link": "https://www.nytimes.com/wirecutter/reviews/instant-coffee-is-good/",
      "title": "Hear Me Out: Instant Coffee Is, in Fact, Good",
      "domain": "www.nytimes.com",
      "source": "The New York Times",
      "snippet": "Not all instant coffee tastes gross.",
      "position": 1
    }
  ],
  "search_parameters": {
    "q": "coffee",
    "gl": "us",
    "hl": "en",
    "page": 1,
    "engine": "google_news"
  }
}

Response fields

Field Type Description
pagination object
pagination.next integer
pagination.current integer
pagination.has_next_page boolean
organic_results[] object[]
organic_results[].date string
organic_results[].link string
organic_results[].title string
organic_results[].domain string
organic_results[].source string
organic_results[].snippet string
organic_results[].position integer
search_parameters object
search_parameters.q string
search_parameters.gl string
search_parameters.hl string
search_parameters.page integer
search_parameters.engine string

Code examples in other languages

Ready-to-run examples live in examples/; each reads your key from AUTOM_API_KEY.

Language google-news
cURL (Bash) google_news.sh
PHP google_news.php
C# GoogleNews.cs
Go google_news.go
Java GoogleNewsExample.java
Ruby google_news.rb
Node.js google_news.mjs

Use cases

  • Media monitoring — Track mentions of your brand and competitors.
  • News aggregation — Build topic feeds from Google News.

Why Autom?

  • Every SERP in one API — Google Search, AI Mode, Maps, News, Shopping, Images, Videos, Jobs, Autocomplete, plus Bing and Brave.
  • Structured JSON — documented fields instead of brittle HTML parsing.
  • Geo & language targeting — search like a user from the country and language you need.
  • One API key, one header — x-api-key on every request.
  • Copy-paste examples — Python and TypeScript in each README, 7 more languages in examples/.

FAQ

How do I authenticate?

Create an account on Autom, copy your API key and send it in the x-api-key header of every request to https://api.autom.dev.

How much does a request cost?

Credits per call: /v1/google/news 1. See Autom pricing.

Which languages are supported?

Any language that can make an HTTP request. This README shows Python and TypeScript; the examples/ folder contains cURL, PHP, C#, Go, Java, Ruby and Node.js.

Official SDKs

Use Autom from your own language with a typed client:

SDK Package Install
Node.js @automdev/sdk npm install @automdev/sdk
Python automdev pip install automdev
Go autom-go go get github.com/automdev/autom-go
.NET Autom dotnet add package Autom
Ruby autom gem install autom
PHP autom/sdk composer require autom/sdk
Java autom-java build from source, see its README
CLI @automdev/cli npm install -g @automdev/cli
MCP server @automdev/mcp npx -y @automdev/mcp

Related repositories

Support


Autom
Built by Autom. Examples are released under the MIT license.

About

Google News API by Autom: Google News articles as structured JSON. Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby examples.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors