HasData icon

HasData

Scrape data from various websites

Google SERP → Get Google News Results

AI-generated

Summary

Fetches Google News search results based on query parameters.

Inputs

  • additionalFields — Optional collection of extra fields to include in the response.
  • q — Free-text search query as used on news.google.com; mutually exclusive with topicToken, storyToken, or publicationToken.
  • location — Google canonical location for the search.
  • uule — Encoded location parameter.
  • moreStores — Fetch additional store results in a single search; defaults to false.
  • nextPageToken — Token to retrieve the next page of store results; used with immersive_product operation.
  • gl — Two-letter country code to limit the search.
  • domain — Google domain to use; defaults to google.com.
  • hl — Two-letter language code for the desired search language.
  • lr — Language filter for websites to return results from; multi-select.
  • cr — Country code for location restriction; used primarily with short_videos operation.
  • start — Number of results to skip for pagination; behavior varies by operation.
  • topicToken — Token for a Google News topic (e.g., World, Business); exclusive with q, storyToken, publicationToken.
  • sectionToken — Token for a sub‑section under a topic; requires topicToken or publicationToken.
  • publicationToken — Token for a specific publisher; exclusive with q, topicToken, storyToken.
  • storyToken — Token for a single news story cluster (Full coverage page).
  • so — Sort order for articles in a story; 0=relevance, 1=date.
  • tbs — Advanced search filters (date range, image presence, etc.) as a comma‑separated string.
  • safe — Adult content filtering setting; active or off.
  • filter — Enable (1) or disable (0) similarity and omission filters for results.
  • nfpr — Show only original query results; 0 includes auto‑corrected results (default).
  • shoprs — Helper ID for applying shopping filters; must be used with an updated q parameter.
  • page — Page number for short video results; 0 is the first page.
  • htichips — Event‑search filter string; supports date and event_type filters.
  • num — Number of results per page, range 10‑100; applicable to web search and shopping.
  • deviceType — Specify device type for the search: desktop, mobile, or tablet.
  • ludocid — Google Place ID for a specific location.
  • lsig — Additional Google Place ID.
  • kgmid — Google Knowledge Graph ID.
  • si — Google Cached Search Parameters ID.

Output shape

an array of news article objects representing the search results

Pagination is controlled by the start parameter; the response may include optional fields such as additionalFields, and results can be filtered via tbs, safe, and other options.

Examples

Example 1: Retrieve the latest news about technology in the United States, returning the first page of results.

q=technology&gl=us&hl=en&num=10

Example 2: Search for business news in Spanish from Spain, including extra fields and safe filtering.

q=business&hl=es&gl=es&additionalFields={"domain":"google.es"}&safe=active

Example 3: Fetch the second page of store results for a product using immersive product mode.

q=wireless headphones&moreStores=true&nextPageToken=abc123&page=1

Links

Discussion