google_news_search
Retrieve news headlines, snippets, sources, and relative timestamps from Google News search results. Supports pagination, country, language, and time filters.
Instructions
Retrieves news search results from Google News (classic search-style scrape), returning headlines, snippets, source names, and relative timestamps. [Credits: 5 API credits per request] Notes: Pagination via page (0-indexed). Results returned are relative-time stamped ('19 hours ago') rather than absolute dates - use google_news_v2 for absolute dates. No id/token concepts used by this endpoint. Returns: { search_information: { query_displayed, url }, news_results: [ { title, snippet, source, lastUpdated, url, favicon } ] }
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lr | No | Limit the search to one or multiple languages. Used as lang_{language_code} (e.g. lang_en). See Google LR Language Page. | |
| tbs | No | Time-Based Search filter: qdr:h (past hour), qdr:d (past 24h), qdr:w (past week), qdr:m (past month), qdr:y (past year), or a custom range. | |
| html | No | Return the full HTML of the Google page instead of parsed JSON. (default: false) | |
| nfpr | No | Excludes results from auto-corrected (spelling-corrected) queries. Set 1 to exclude, 0 to include. (default: 0) | |
| page | No | Page number of Google searches. 0 = first page, 1 = second page, etc. (default: 0) | |
| safe | No | Adult content filter. Set to active to filter, or off to disable. (default: off) | |
| uule | No | Specifies the geographic location/locale for tailored results (e.g. w+CAIQIFJlbGF5IFN0YXRlcw==). Cannot be used with a location parameter. | |
| query | Yes | Google Search query. Example: query=pizza | |
| domain | No | Google domain to get local results from a specific country, e.g. google.co.in for India, google.co.uk for the UK. See Google Domains Page. (default: google.com) | |
| country | No | ISO code of the country from which to get Google search results. See Google Country Parameter docs for full list. (default: us) | |
| results | No | Number of results to scrape. Value between 1 and 100. (default: 10) | |
| language | No | Language of the results, e.g. en, es, fr, de. See Google Language Page for full list. (default: en) |