Skip to main content
POST
/
v1
/
monitor
/
google
/
news
Monitor Google News Results
curl --request POST \
  --url https://api.cloro.dev/v1/monitor/google/news \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "climate change",
  "country": "US",
  "device": "desktop",
  "pages": 1,
  "include": {
    "html": false
  }
}
'
{
  "success": true,
  "result": {
    "newsResults": [
      {
        "position": 1,
        "title": "Major Climate Summit Reaches Historic Agreement",
        "link": "https://example.com/climate-summit-agreement",
        "snippet": "World leaders agreed on new climate targets at the summit...",
        "source": "The Guardian",
        "date": "2 hours ago",
        "thumbnail": "https://example.com/images/climate-summit.jpg"
      }
    ],
    "html": [
      "https://storage.cloro.dev/results/a12b3c4d-5e6f-7g8h-9i0j-k1l2m3n4o5p6/page-1.html"
    ]
  }
}

Overview

The Google News endpoint extracts structured news articles from Google News, including titles, links, snippets, sources, publication dates, and thumbnail images.

Request parameters

Required parameters:
  • query (string): The search query to execute on Google News (1-10,000 characters)
Optional parameters:
  • country (string): ISO 3166-1 alpha-2 country code for localized news results. Defaults to US
  • device (string): Device type for news results. Options: desktop (default), mobile
  • pages (integer): Number of news results pages to scrape (1-10). Defaults to 1
  • include.html (boolean): Include raw HTML response. Defaults to false

Response schema

Includes common response fields plus:

Google News results

FieldTypeDescription
result.newsResultsarrayNews articles from Google News
result.htmlarrayRaw HTML response (if requested)

News articles

FieldTypeDescription
positionnumberPosition in news results (1-indexed)
titlestringTitle of the news article
linkstringURL of the news article
snippetstringText snippet describing the article
sourcestringNews source/publisher name
datestringPublication date (e.g., “2 hours ago”)
thumbnailstringThumbnail image URL (when available)

Usage examples

{
  "query": "climate change",
  "country": "US"
}
Scrape multiple pages of news results:
{
  "query": "artificial intelligence",
  "pages": 3,
  "country": "GB"
}
This will scrape the first 3 pages of Google News results, combining all news articles into a single response.

Mobile news results

Get news results optimized for mobile devices:
{
  "query": "technology news",
  "device": "mobile",
  "country": "US"
}

Include HTML response

Request raw HTML alongside structured data:
{
  "query": "sports news",
  "country": "US",
  "include": {
    "html": true
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request parameters for monitoring Google News results

query
string
required

The search query to execute on Google News

Required string length: 1 - 10000
Example:

"climate change"

country
string

ISO 3166-1 alpha-2 country code for localized news results

Example:

"US"

device
enum<string>
default:desktop

Device type for news results

Available options:
desktop,
mobile
Example:

"desktop"

pages
integer
default:1

Number of news results pages to scrape (1-10)

Required range: 1 <= x <= 10
Example:

1

include
object

Optional flags for including additional response data

Response

successful Google News monitoring response

success
boolean
required
Example:

true

result
object
required

Google News results data