Clair API
  • All APIs
  • Pricing
  • Docs
Web Scraping
  • Web Scraper API
E-commerce
  • Amazon API
    • Product
    • Reviews
    • Search
    • Price
    • Best sellers
    • Seller
    • ASIN lookup
  • Google Shopping API
SERP & Search
  • Google Search API
  • Google Maps API
    • Scraper
    • Place
AI Search
  • ChatGPT API
  • Google AI Overview API
  • Google AI Mode API
Jobs & Hiring
  • Glassdoor API
    • Jobs
    • Reviews
    • Salary
  • Indeed API
Company Data & Reviews
  • Trustpilot API
  • Crunchbase API
    • Company
    • People
Video & Social
  • YouTube API
  • TikTok API
  • Instagram API
News & Media
  • Google News API
  • Reuters API
  • Bloomberg API
  • Associated Press API
  • Use cases
  • Comparisons
  • Glossary
Ecommerce and reviews
  • Amazon price monitoring
  • Trustpilot review monitoring
  • MAP enforcement on Amazon
  • Amazon rating monitoring
  • Amazon category research
  • Trustpilot competitor benchmarking
  • Google Shopping price tracking
Search and local
  • Google rank tracking
  • Local lead generation
  • Local SEO competitor audit
  • Grounding LLM answers in search results
  • Content research from People also ask
AI search
  • AI visibility tracking
  • Find the sites AI answers cite
  • AI Overview tracking for SEO keywords
Leads and companies
  • Account research briefs
Jobs and hiring
  • Salary benchmarking
  • Job market analytics
  • Employer reputation tracking
News
  • Brand and media monitoring
  • Financial news tracking
  • News corpus for research and RAG
Social and video
  • YouTube transcripts for RAG
  • Instagram engagement rate
  • Influencer campaign tracking
Comparisons
  • Clair vs SerpApi
  • Clair vs Google Places API
  • Clair vs Google Custom Search API
GlossarySERPSERP APIPeople also askGoogle place IDASINBuy BoxGTINSalary percentilesTrustScoreRating distributionAll 47 terms →
PricingDocsStatus
Dashboard
  • Use cases
  • Google News API
  • News aggregator
  • Wire service
  • Byline

Brand and media monitoring

Kaan Ersoy·2 min read·Sep 28, 2026

{ }
Find new stories that mention your company, products, or executives, soon after they are published, from outlets Google News indexes. An hourly search per term and market, deduplicated across searches, gives you each new headline and the outlet that ran it, to open and read.
Try the Google News API →

On this page

  1. Who
  2. Pipeline
  3. Code
  4. Cost
  5. Limits
  6. FAQ

Who runs this, and what for

TeamWhat they decide with it
PR and communications teamsWhich new stories about the company to open and read today, and which outlets ran them.
Brand and marketing teamsWhere a launch or campaign was picked up, for reports and follow-up.

The calls, step by step

  1. 1. Write the search terms

    Google News search accepts quoted phrases, so "Acme Corp" does not match every story with acme in it. Add the CEO's name with a qualifier, and your domain for stories that link to you. when=1h limits results to the last hour.

    The news.google.com page this step reads
    The page on news.google.com that this call reads, as a signed-out visitor sees it. The response below is what Clair returns from it.

    GET /v1/google-news?topic=WORLD&country=nz · query

    {
      "q": null,
      "when": null,
      "topic": "WORLD",
      "topic_token": null,
      "section_token": null,
      "location": null,
      "story_token": null,
      "publication_token": null,
      "language": "en",
      "country": "nz",
      "page": 1
    }
    Recorded response. Live values differ.
  2. 2. Deduplicate across searches

    The same story shows up for several terms and markets, sometimes at different URLs. Key on the outlet name plus the title. Each result has the publisher's own url to open and published_at to the second, so you can also drop anything older than your last run.

    GET /v1/google-news?topic=WORLD&country=nz · results.0

    {
      "position": 1,
      "title": "North Korean operative posing as IT contractor hired by NZ business",
      "url": "https://www.1news.co.nz/2026/09/24/north-korean-operative-posing-as-it-contractor-hired-by-nz-business/",
      "google_url": "https://news.google.com/read/CBMiEXAMPLE",
      "source": {
        "name": "1News",
        "domain": "1news.co.nz"
      },
      "published_at": "2026-09-24T17:03:04.000Z",
      "authors": [
        "Ed O'driscoll"
      ]
    }
    Recorded response. Live values differ.
  3. 3. Cover each market

    country and language pick the Google News edition. A story in a British outlet may appear only in the gb edition, so search every market you care about.

    GET /v1/google-news?topic=WORLD&country=nz · query.country

    "nz"
    Recorded response. Live values differ.

A script to start from

media_monitor.py

# Hourly media monitoring: new Google News headlines for brand terms,
# deduplicated across terms and markets. Keeps seen keys in seen.json.
import json, os, pathlib, requests

API = "https://api.clair.im"
HEADERS = {"Authorization": f"Bearer {os.environ['CLAIR_API_KEY']}"}
TERMS = ['"Acme Corp"', '"Jane Doe" CEO', "acme.com"]
MARKETS = [("en", "us"), ("en", "gb")]
STATE = pathlib.Path("seen.json")
seen = set(json.loads(STATE.read_text())) if STATE.exists() else set()

def headlines(q, language, country):
    # A busy term fills more than one page in an hour; follow next_cursor.
    page = 1
    while page:
        r = requests.get(f"{API}/v1/google-news", headers=HEADERS, timeout=60, params={
            "q": q, "when": "1h", "page": page,
            "language": language, "country": country})
        r.raise_for_status()
        body = r.json()
        yield from body["results"]
        page = body["next_cursor"]

def story_key(item):
    # Outlets syndicate and markets overlap, so key on outlet and headline
    # rather than the URL.
    return f"{item['source']['name'].lower()}|{item['title'].lower()}"

for term in TERMS:
    for language, country in MARKETS:
        for item in headlines(term, language, country):
            key = story_key(item)
            if key in seen:
                continue
            seen.add(key)
            print(f"[{item['source']['name']}] {item['title']}\n  {item['url']}")

STATE.write_text(json.dumps(sorted(seen)))

Set CLAIR_API_KEY to your Clair key; one plan covers the Google News API. Each call spends that API's rate from the plan's monthly balance.

What it costs per month

ScheduleRequestsPlanPer monthPer 1,000
3 terms × 1 market, hourly3 searches × 24 hours × 30 days = 2,160 requests.2,160Starter$30$13.89
3 terms × 2 markets, every 3 hours6 searches × 8 runs × 30 days = 1,440 requests, with when=1d.1,440Starter$30$20.83
10 terms × 1 market, daily10 searches × 30 days = 300 requests, with when=1d.300Starter$30$100
20 terms × 3 markets, hourly60 searches × 720 hours = 43,200 requests.43,200Advanced$300$6.94
The cheapest Clair plan whose monthly balance covers each volume, every API spending from the same balance. USD, before tax. The free tier is $1 of usage a month, for trying the pipeline.

What to plan for

  • Headlines only. Google News links to the publisher; for article text, read Reuters, AP, or Bloomberg stories with their APIs, or fetch the publisher page yourself.
  • Search reaches 10 pages of about 10 results. With when=1h that covers most terms; a very common term returns the most relevant stories, not all of them, so make terms specific. Each extra page is one more request.
  • When Google blocks a request, the API returns scrape_failed rather than older results. After a failed run, search the next one with when=1d so the missed hour is covered; the seen keys drop the repeats.
  • This is a headline feed to read, not a screening tool. A capped search can miss stories, so do not rely on it where a missed mention has legal or compliance weight.
  • Google News covers outlets it indexes. Trade blogs, newsletters, and social posts are mostly not there.

Common questions

How quickly do new stories appear?

As fast as Google News indexes them, often within minutes for major outlets. An hourly check catches most stories within the hour.

Can I get sentiment?

Not from the API. Pass the title, or the article text where you have it, to your own classifier or a language model.

Does it cover non-English news?

Yes. Set language and country to the edition, such as de and de for German news in Germany.

Keep reading

APIs

  • Google News API

Glossary

  • News aggregator
  • Wire service
  • Byline
  • RSS feed
    Clair API

    Live data APIs for search, news, jobs, marketplaces, companies, reviews, and social video, plus a scraper for any public page. Each call fetches the page when you ask.

    contact@serinlabs.com@clair_api

    APIs

    Web Scraping
    • Web Scraper API
    E-commerce
    • Amazon API
      • Amazon Product API
      • Amazon Reviews API
      • Amazon Search API
      • Amazon Price API
      • Amazon Best Sellers API
      • Amazon Seller API
      • Amazon ASIN Lookup API
    • Google Shopping API
    SERP & Search
    • Google Search API
    • Google Maps API
      • Google Maps Scraper API
      • Google Maps Place API
    AI Search
    • ChatGPT API
    • Google AI Overview API
    • Google AI Mode API
    Jobs & Hiring
    • Glassdoor API
      • Glassdoor Jobs API
      • Glassdoor Reviews API
      • Glassdoor Salary API
    • Indeed API
    Company Data & Reviews
    • Trustpilot API
    • Crunchbase API
      • Crunchbase Company API
      • Crunchbase People API
    Video & Social
    • YouTube API
    • TikTok API
    • Instagram API
    News & Media
    • Google News API
    • Reuters API
    • Bloomberg API
    • Associated Press API

    Use cases

    Ecommerce and reviews
    • Amazon price monitoring
    • Trustpilot review monitoring
    • MAP enforcement on Amazon
    • Amazon rating monitoring
    • Amazon category research
    • Trustpilot competitor benchmarking
    • Google Shopping price tracking
    Search and local
    • Google rank tracking
    • Local lead generation
    • Local SEO competitor audit
    • Grounding LLM answers in search results
    • Content research from People also ask
    AI search
    • AI visibility tracking
    • Find the sites AI answers cite
    • AI Overview tracking for SEO keywords
    Leads and companies
    • Account research briefs
    Jobs and hiring
    • Salary benchmarking
    • Job market analytics
    • Employer reputation tracking
    News
    • Brand and media monitoring
    • Financial news tracking
    • News corpus for research and RAG
    Social and video
    • YouTube transcripts for RAG
    • Instagram engagement rate
    • Influencer campaign tracking

    Compare and learn

    Comparisons
    • Clair vs SerpApi
    • Clair vs Google Places API
    • Clair vs Google Custom Search API
    Glossary
    • SERP
    • SERP API
    • People also ask
    • Google place ID
    • ASIN
    • Buy Box
    • All 47 terms
    Developers
    • Documentation
    • Quickstart
    • API catalog
    • Pricing
    • Status
    • All resources
    Featured onCITABLEClair API - Featured on Startup FameFeatured on Twelve Tools Listed on Turbo0 Featured on Wired BusinessClair API on Nick Launches Featured on neeed.directory Featured on DailyPings ShareSpeak on SaaSGrow Startup Benchmarks Featured on LaunchVault Featured on EasyLaunch Featured on SubmitMySaas Featured on DodoDirectory Featured on LaunchZone Featured on LemonLaunch 'LiftOff' Default v2 badge Launched on LaunchBoard - Product Launch Platform Listed on CurlShip aListed onamaze.directory Featured on Brick Launch Featured on saas.fyi Featured on Wall of Tools Featured onfreeboard.lolFeatured on Yo.directory Featured on TheDevToolsIndex
    Featured onCITABLEClair API - Featured on Startup FameFeatured on Twelve Tools Listed on Turbo0 Featured on Wired BusinessClair API on Nick Launches Featured on neeed.directory Featured on DailyPings ShareSpeak on SaaSGrow Startup Benchmarks Featured on LaunchVault Featured on EasyLaunch Featured on SubmitMySaas Featured on DodoDirectory Featured on LaunchZone Featured on LemonLaunch 'LiftOff' Default v2 badge Launched on LaunchBoard - Product Launch Platform Listed on CurlShip aListed onamaze.directory Featured on Brick Launch Featured on saas.fyi Featured on Wall of Tools Featured onfreeboard.lolFeatured on Yo.directory Featured on TheDevToolsIndex
    © 2026 Serin Technologies, LLC
    • About Clair
    • Terms of Service
    • Privacy Policy