Skip to main content
POST
Search Google News by keyword, date, site and country, or read headlines by topic
  • Endpoint: google.news
  • Returns: data has results, isPartial.
  • Cost: 1 credit per 10 articles returned, never more than you asked for (5 credits at most). Failed calls cost nothing.
  • Paging: No.
Search by query, or leave it out and pick a topic for the top headlines.

Example

Authorizations

Authorization
string
header
required

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

Body

application/json
limit
integer
default:10

How many articles to return, up to 50. Headlines (no query) give up to 10.

Required range: 1 <= x <= 50
query
string
Required string length: 1 - 400
topic
enum<string>

Headlines for one section instead of a search. Send query or topic, not both.

Available options:
world,
nation,
business,
technology,
entertainment,
sports,
science,
health
country
string

ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.

Pattern: ^[A-Za-z]{2}$
language
string

Two-letter language code like en or pt. Any case is accepted.

Pattern: ^[A-Za-z]{2}$
includeDomains
string[]
Maximum array length: 10
excludeDomains
string[]
Maximum array length: 10
within
enum<string>
default:all
Available options:
hour,
day,
week,
month,
year,
all

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required