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",
        "page": 1,
        "thumbnail": "https://example.com/images/climate-summit.jpg"
      }
    ],
    "html": [
      "https://storage.cloro.dev/results/a12b3c4d-5e6f-7g8h-9i0j-k1l2m3n4o5p6/page-1.html"
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.cloro.dev/llms.txt

Use this file to discover all available pages before exploring further.

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)

Response objects

The response includes the following sections. See each subpage for the full schema.
SectionDescription
News articlesArticle titles, links, snippets, sources, publication dates, and thumbnails

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