Skip to main content
Scrape Google News (search or section)

Authorizations

x-scrapeunblocker-key
string
header
required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

q
string | null

Search query, e.g. 'tesla' or '"web scraping"'. Google News operators work: quotes, OR, -word, site:reuters.com, intitle:. Pass either q or topic.

topic
string | null

A section instead of a search: world, nation, business, technology, entertainment, sports, science, health, or top (the edition's headlines). A Google News topic id (the 'CAAq...' part of a news.google.com/topics/ URL) also works.

hl
string
default:en

Language of the Google News edition, e.g. 'en', 'en-GB', 'de', 'fr', 'pt-BR'.

gl
string
default:us

Country of the Google News edition (2-letter code), e.g. 'us', 'gb', 'de'.

when
string | null

Only articles from the last period: '1h' to '720h', '1d', '7d', '2w', '1m', '1y'. Search (q) only.

after
string | null

Only articles published after this date (YYYY-MM-DD). Search only.

before
string | null

Only articles published before this date (YYYY-MM-DD). Search only.

max_results
integer
default:100

Most articles to return, 1-250. Google News returns up to about 100 articles for a search and about 250 for a section; one call is billed one unit whatever the count.

Response

JSON with an articles array.