Google News API

Request

curl -X POST "https://api.answerline.dev/v1/monitor/google/news" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"electric vehicle battery","country":"FR","hl":"fr"}'

Request options

* required. Nested fields are written with a dot, e.g. include.markdown.

What you get back

Full field definitions are in the API reference.

Google News results versus developer APIs

This endpoint returns Google News results for a query, country and interface language as newsResults: the articles, their publishers, dates and positions as a reader sees them.

Google’s JSON API for web search, the Custom Search JSON API, does not return that list. Its overview (checked 2026-09-17, developers.google.com) says it returns web and image results from a Programmable Search Engine, is closed to new customers, and gives existing customers until January 1, 2027 to transition. Its cse.list reference (checked 2026-09-17, developers.google.com) does not mention news results.

A publisher feed or news database gives you coverage. It does not tell you which outlets Google surfaces for a query and in what order, which is what readers see first. The same query can also surface different publishers in different countries and languages; country/gl and hl make each edition a separate, repeatable measurement. Every article comes back on page 1, in position order, so you can measure how far down a story sits.

An annotated response

The excerpt follows the result schema for POST /v1/monitor/google/news. Values are illustrative.

{
  "success": true,
  "result": {
    "newsResults": [
      {
        // 1-indexed position across the results returned.
        "position": 1,
        "title": "Battery makers race to cut cobalt use",
        // A news.google.com redirect to the article.
        "link": "https://news.google.com/rss/articles/CBMiExample?oc=5",
        // Publisher name as shown.
        "source": "Example News",
        // Publication time, ISO 8601 UTC.
        "date": "2026-10-19T08:30:00.000Z",
        // Always 1: every article is on page 1.
        "page": 1
      },
      {
        "position": 2,
        "title": "Electric vehicle battery prices: what changed this quarter",
        "link": "https://news.google.com/rss/articles/CBMiExample2?oc=5",
        "source": "Example Auto",
        "date": "2026-10-18T16:05:00.000Z",
        "page": 1
      }
    ]
  }
}

Parsing notes:

• date is an ISO 8601 UTC timestamp. source and date are omitted when the feed has none.
• There is no snippet, thumbnail or redirectLink.
• link is a news.google.com redirect. POST /v1/monitor/google/goto does not resolve it.

Synchronous calls

A synchronous call returns the results in the response and waits up to five minutes. One page costs $0.0002, the same as a task.

Python (requests)

import os
from collections import Counter
import requests

API = "https://api.answerline.dev"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

resp = requests.post(
    f"{API}/v1/monitor/google/news",
    headers=HEADERS,
    json={"query": "electric vehicle battery", "country": "FR", "hl": "fr"},
    timeout=330,
)
if resp.status_code != 200:
    raise RuntimeError(f"{resp.status_code} {resp.headers.get('X-Request-Id')} {resp.text}")

articles = resp.json()["result"].get("newsResults", [])
publishers = Counter(a.get("source") for a in articles)
print(len(articles), "articles")
print("top publishers:", publishers.most_common(5))
for a in articles[:5]:
    print(a["position"], a.get("source"), "|", a.get("title"), "|", a.get("date"))
print("charged (USD):", resp.headers.get("X-Credits-Charged"))

TypeScript (fetch)

const API = "https://api.answerline.dev";

const res = await fetch(`${API}/v1/monitor/google/news`, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ query: '"Example Corp" lawsuit', gl: "us", hl: "en" }),
  signal: AbortSignal.timeout(330_000),
});
if (!res.ok) throw new Error(`${res.status} ${res.headers.get("X-Request-Id")} ${await res.text()}`);

const { result } = await res.json();
for (const article of result.newsResults ?? []) {
  console.log(article.position, article.source, article.title, article.date, article.link);
}
console.log("charged (USD):", res.headers.get("X-Credits-Charged"));

Batches: async tasks and a webhook

Scheduled news monitoring belongs in tasks: $0.0002 per page-one task, queued and posted to your webhook. POST /v1/async/task/batch accepts 1 to 500 tasks, each admitted on its own and answered by index.

Python: a watchlist across editions

import datetime
import os
import requests

API = "https://api.answerline.dev"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
hour = datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H")

watchlist = ['"Example Corp"', '"Example Corp" CEO', '"Example Corp" fine OR investigation']
editions = [("US", "en"), ("GB", "en"), ("DE", "de"), ("FR", "fr")]

tasks = [
    {
        "taskType": "GOOGLE_NEWS",
        "payload": {"query": q, "country": country, "hl": hl},
        "idempotencyKey": f"news-{i}-{country}-{hl}-{hour}",
        "webhook": {"url": "https://your-app.example/hooks/news"},
    }
    for i, q in enumerate(watchlist)
    for country, hl in editions
]

resp = requests.post(f"{API}/v1/async/task/batch", headers=HEADERS, json=tasks, timeout=60)
resp.raise_for_status()
body = resp.json()
print(body["summary"])
for item in body["results"]:
    if not item["success"] and item["error"]["code"] != "RESOURCE_ALREADY_EXISTS":
        print(tasks[item["index"]]["idempotencyKey"], item["error"]["code"])

TypeScript: receive deliveries and flag new articles (Express)

Each delivery carries the GET /v1/async/task/{taskId} body. Verify Webhook-Signature over the raw body before parsing.

import express from "express";
import { createHmac, timingSafeEqual } from "node:crypto";

const seenLinks = new Set<string>(); // use a database table in production

function verify(raw: Buffer, header: string | undefined, secret: string, toleranceSeconds = 300): boolean {
  const pairs = (header ?? "").split(",").map((part) => part.split("="));
  const stamps = pairs.filter(([k]) => k === "t").map(([, v]) => v);
  const sigs = pairs.filter(([k]) => k === "v1").map(([, v]) => v);
  if (stamps.length !== 1 || !/^\d+$/.test(stamps[0]) || sigs.length === 0) return false;
  if (Math.abs(Date.now() / 1000 - Number(stamps[0])) > toleranceSeconds) return false;
  const expected = createHmac("sha256", secret).update(`${stamps[0]}.`).update(raw).digest();
  return sigs.some((sig) => {
    const given = Buffer.from(sig, "hex");
    return given.length === expected.length && timingSafeEqual(given, expected);
  });
}

const app = express();
app.post("/hooks/news", express.raw({ type: "application/json" }), (req, res) => {
  if (!verify(req.body, req.get("webhook-signature"), process.env.WEBHOOK_SECRET!)) return res.sendStatus(400);
  const delivery = JSON.parse(req.body.toString("utf8"));
  if (delivery.test) return res.sendStatus(204);
  const { task, response } = delivery;
  if (task.status !== "COMPLETED") {
    console.warn(task.idempotencyKey, "failed:", response.error.code);
    return res.sendStatus(204);
  }
  for (const article of response.result.newsResults ?? []) {
    if (seenLinks.has(article.link)) continue;
    seenLinks.add(article.link);
    console.log("NEW", task.idempotencyKey, article.source, article.title, article.link);
  }
  res.sendStatus(204);
});
app.listen(3000);

Deliveries can repeat and arrive out of order, so deduplicate on task.id. See webhooks.

Geo and language targeting

Google News has no location or state; country and language set the edition. For multilingual watchlists, write the query in each edition’s language instead of reusing an English query everywhere; multilingual AI answers applies the same principle to assistants.

Include flags and what they cost

A 10-page task costs $0.0002, the same as a one-page task, and returns the same articles.

result.provenance reads interface rss (all fields).

Common workloads

• News monitoring: coverage of a company, product or topic per edition. See news monitoring and the Google News API post.
• Adverse media screening: names combined with risk terms, run on a schedule and reviewed by analysts. See adverse media screening.
• Brand protection and crisis response: which outlets carry a story and how prominently. See brand protection and brand crisis AI monitoring.
• Threat intelligence: breach, fraud and impersonation coverage for an organization. See threat intelligence.
• AI answer context: pair news results with ChatGPT or Gemini answers on the same topic to see which coverage reaches assistant answers.

Pitfalls

Positions and the article set change as stories develop. Keep a stable cadence per query, put the run period in the idempotency key, and compare like-for-like periods.

Syndicated stories can share titles across publishers, so key articles on link and use source as the publisher.

Quote names to avoid partial matches, and review screening hits by hand: a surname match is not an adverse finding.

Pages above 1 are free but add no articles. Leave pages at 1.

Hourly watchlists across many editions add up. Tasks queue; a submission that would overflow your queue is rejected whole with 429 QUEUE_LIMIT_EXCEEDED. See rate limits.

How failures are billed

An accepted request reserves its cost and is charged it on success. A failed request is charged nothing and its reservation is released. Tasks that never start within 4 hours of creation fail uncharged with QUEUE_WAIT_EXCEEDED and can be resubmitted. Synchronous calls are charged on success even if your connection dropped, so resend them only when the request never reached the server. See credits.

Related: Google News RSS feeds and free news APIs.

Other engines