Google News
Search Google News via API and retrieve structured news results with pagination.
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringQuery to search on Google News (keywords, company, topic).
page?numberPage number for pagination (1 = first page).
"1"num?numberMaximum number of results per page (e.g. 10).
"10"google_domain?stringGoogle domain to use for the search. Defaults to google.com.
Examples:
google.comgoogle.co.ukgoogle.fr
Example:
google.com"google.com"gl?stringCountry to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France).
Example:
ushl?stringLanguage to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419).
Example:
encr?stringLimit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).
Example:
countryUSlr?stringLimit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).
Example:
lang_enfields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
pagination?organic_results?array<>search_parameters?curl -X GET 'https://api.autom.dev/v1/google/news?query=string'{ "pagination": { "next": 2, "current": 1, "has_next_page": true }, "organic_results": [ { "date": "1 day ago", "link": "https://www.nytimes.com/wirecutter/reviews/instant-coffee-is-good/", "title": "Hear Me Out: Instant Coffee Is, in Fact, Good", "domain": "www.nytimes.com", "source": "The New York Times", "snippet": "Not all instant coffee tastes gross.", "position": 1 } ], "search_parameters": { "q": "coffee", "gl": "us", "hl": "en", "page": 1, "engine": "google_news" }}