SerpBase

Google News Search — API reference

POST
Available
/google/news/search

Google News Search

Search Google News by topic or keywords. Available articles and publisher fields depend on the upstream results.

type
news
result
news
Billing
1 credits

Search Google News by topic or keywords. Available articles and publisher fields depend on the upstream results.

Parameters
q
required
string

required

Search query string.

hl
optional
string

optional

Language code. Defaults to en.

gl
optional
string

optional

Country code. Defaults to us.

page
optional
number

optional

1-based page number. Defaults to 1.

query
sample
string

Catalog sample; the API validates required fields.

sample: "semiconductor supply"

json
{
  "query": "semiconductor supply"
}
Open in Playground
Response fields
query
required
string

required

Normalized query from the request.

page
required
number

required

Current 1-based page number.

news
optional
NewsResult[]

When news results are parsed.

Google News results.

NewsResult Result item schema
rank
required
number

required

1-based ranking position in this response.

position
optional
number

Alias for rank when available.

Normalized rank alias for clients that expect position.

title
required
string

required

Result title.

link
required
string

required

Primary link returned by the parser.

url
optional
string

Present for normalized result links.

Canonical target URL, usually the same value as link.

source_url
optional
string

Only when Google redirect/source URL is observed.

Original Google URL kept for debugging and provenance.

display_url
optional
string

When Google display text or a domain can be derived.

Display URL or source domain.

source
optional
string

When publisher text is parsed.

Publisher/source label.

time
optional
string

When Google exposes time text.

Raw published time text.

published_at
optional
string

Alias for parsed time when available.

Normalized published time alias.

snippet
optional
string

When a snippet is parsed.

Article summary snippet.

thumbnail_url
optional
string

When Google exposes a thumbnail.

Thumbnail URL.

thumbnail
optional
string

Alias for thumbnail_url when available.

Normalized thumbnail alias.

Code and response examples
bash
curl -X POST 'https://api.serpbase.dev/google/news/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"semiconductor supply"}'
Existing Google request example
bash
curl -X POST https://api.serpbase.dev/google/news/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "apple event",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
Notes

Brand monitoring, trend tracking, media discovery.

Source and time are parsed from compact Google metadata text, so clients should treat both as optional.