The Google News API offers real-time access to comprehensive news articles from Google, enabling users to fetch news based on specific queries, locations, publishers, and various filter options for tailored news feeds.

​
Get Your API Key

Sign in at hasdata.com, go to your account settings, and copy your API key. All requests must include your key in the x-api-key header.

​
Make Your First Request

curl --request GET \
  --url 'https://api.hasdata.com/scrape/google/serp?q=Apple&location=Austin%2CTexas%2CUnited%20States&tbm=nws&deviceType=desktop' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'

​
API Parameters

ParameterDefault ValueRequiredDescription
qAppleYesSpecify the search term for which you want to scrape the SERP.
locationAustin,Texas,United StatesNoGoogle canonical location for the search.
uule-NoThe encoded location parameter.
domain-NoGoogle domain to use. Default is google.com.
gl-NoThe two-letter country code for the country you want to limit the search to.
hl-NoThe two-letter language code for the language you want to use for the search.
lr-NoThe ‘lr’ parameter specifies the language of the websites to return results from. This parameter filters results based on the language of the web content.
ludocid-NoThe Google Place ID for a specific location.
lsig-NoAdditional Google Place ID.
kgmid-NoGoogle Knowledge Graph ID.
si-NoGoogle Cached Search Parameters ID.
tbs-NoThis parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters:

- Specific Time Range: cdr:1,cd_min:10/17/2018,cd_max:3/8/2021 - Filter results to show only those within the defined date range.
- Sort by Date: sbd:1 - Results are sorted by date, from the most recent to the oldest.
- Sort by Relevance: sbd:0 - Results are sorted by relevance to the search query.
- Sites with Images: img:1 - Only show results from webpages that contain images.

Quick Date Range (qdr):
- qdr:h - Show results from the past hour.
- qdr:d - Limit results to the past day.
- qdr:w - Filter results from the week.
- qdr:m - Display results from the past month.
- qdr:y - Show results from the past year.
- qdr:h10, qdr:d10, qdr:w10, qdr:m10, qdr:y10 - Specify a number to show results from the last 10 hours, days, weeks, months, or years respectively.

These filters enhance the control over search results, allowing for precise retrieval of information based on specific criteria.
safe-NoAdult Content Filtering option.
filter-NoDefines whether to enable or disable the filters for ‘Similar Results’ and ‘Omitted Results’. Set to 1 (default) to enable these filters, or 0 to disable them.
tbmnwsNoSpecify the type of search.
deviceTypedesktopNoSpecify the device type for the search.
start-NoThis parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and 20 to the third page.
num-NoNumber of results per page, ranging from 10 to 100.