Logo SearchApi

Google News Light API

GET   /api/v1/search?engine=google_news_light

Google News Light API provides a simplified version of Google News API that enables you to search and retreive news and top stories from various sources much faster. You can also refine your search by applying different filters.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Parameter defines the query you want to search. You can use anything that you would use in a regular Google search. e.g. inurl:, site:, intitle:. We also support advanced search query parameters such as as_dt and as_eq.

Geographic Location

  • Name
    location
    Required
    Optional
    Description

    Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Head to the Locations API if you need more precise control.

  • Name
    uule
    Required
    Optional
    Description

    Parameter is the Google encoded location you want to use for the search. SearchApi automatically generated the uule parameter when you use the location parameter but we allow you to overwrite it directly. uule and location parameters can't be used together.

Localization

  • Name
    google_domain
    Required
    Optional
    Description

    The default parameter google.com defines the Google domain of the search. Check the full list of supported Google google_domain domains.

  • Name
    gl
    Required
    Optional
    Description

    The default parameter us defines the country of the search. Check the full list of supported Google gl countries.

  • Name
    hl
    Required
    Optional
    Description

    The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages.

Filters

  • Name
    time_period
    Required
    Optional
    Description

    This parameter restricts results to URLs based on date. Supported values are:

    • last_hour - data from the past hour.
    • last_day - data from the past 24 hours.
    • last_week - data from the past week.
    • last_month - data from the past month.
    • last_year - data from the past year.

  • Name
    sort_by
    Required
    Optional
    Description

    By default, news results are sorted by relevance. To get the most recent articles, set it to most_recent.

  • Name
    nfpr
    Required
    Optional
    Description

    This parameter controls whether results from queries that have been auto-corrected for spelling errors are included. To exclude these auto-corrected results, set the value to 1. By default, the value is 0, meaning auto-corrected results are included.

  • Name
    filter
    Required
    Optional
    Description

    This parameter controls whether the "Duplicate Content" and "Host Crowding" filters are enabled. Set the value to 1 to enable these filters, which is the default setting. To disable these filters, set the value to 0.

  • Name
    safe
    Required
    Optional
    Description

    This parameter toggles the SafeSearch feature for the results. SafeSearch operates by filtering out adult content from your search results. Google's filters use proprietary technology to check keywords, phrases and URLs. While no filters are 100 percent accurate, SafeSearch will remove the overwhelming majority of adult content from your search results. Set the value to active to enable SafeSearch. To disable it, set the value to off. By default, SafeSearch is disabled.

Pagination

  • Name
    num
    Required
    Optional
    Description

    This parameter specifies the number of results to display per page. Use in combination with the page parameter to implement pagination functionality.

  • Name
    page
    Required
    Optional
    Description

    This parameter indicates which page of results to return. By default, it is set to 1. Use in combination with the num parameter to implement pagination.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to google_news_light.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=google_news_light&location=New+York&q=AI
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_news_light",
  "q": "AI",
  "location": "New York"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
    "search_metadata": {
        "id": "search_vr7K8ndWgWe1idN83P45k2mY",
        "status": "Success",
        "created_at": "2025-07-14T16:46:13Z",
        "request_time_taken": 1.3,
        "parsing_time_taken": 0.1,
        "total_time_taken": 1.4,
        "request_url": "https://www.google.com/search?q=AI&oq=AI&gl=us&hl=en&uule=w+CAIQICIWTmV3IFlvcmssVW5pdGVkIFN0YXRlcw&sourceid=chrome&ie=UTF-8&tbm=nws",
        "html_url": "https://www.searchapi.io/api/v1/searches/search_vr7K8ndWgWe1idN83P45k2mY.html",
        "json_url": "https://www.searchapi.io/api/v1/searches/search_vr7K8ndWgWe1idN83P45k2mY"
    },
    "search_parameters": {
        "engine": "google_news_light",
        "q": "AI",
        "device": "desktop",
        "location": "New York",
        "location_used": "New York,United States",
        "google_domain": "google.com",
        "hl": "en",
        "gl": "us"
    },
    "search_information": {
        "query_displayed": "AI",
        "detected_location": "New York"
    },
    "organic_results": [
        {
            "position": 1,
            "title": "Alibaba-backed Moonshot releases new Kimi AI model that beats ChatGPT, Claude in coding — and it costs less",
            "link": "https://www.cnbc.com/2025/07/14/alibaba-backed-moonshot-releases-kimi-k2-ai-rivaling-chatgpt-claude.html",
            "source": "CNBC",
            "date": "1 day ago",
            "snippet": "Alibaba-backed startup Moonshot released its Kimi K2 model as a low-cost, open source large language model, the two factors underlying...",
            "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSey_-zhzcMbBXeRMuubeEQYadcMpyXtOVDvUcuxocBrzI-6xuT_NbfYHoKaQ&s"
        },
        {
            "position": 2,
            "title": "The government wants AI to fight wars and review your taxes",
            "link": "https://www.washingtonpost.com/business/2025/07/14/trump-ai-government-war-taxes-jobs/",
            "source": "The Washington Post",
            "date": "1 hour ago",
            "snippet": "The Trump administration is pushing the Pentagon, IRS and other federal agencies to rapidly adopt AI tools to improve efficiency,...",
            "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRJntqOOI6kiuYPj4F0Sdk13eHC4BY2M9jQuzTLufcQ1BD1Q4VtPglHduO2FQ&s"
        },
        ...
    ]
}

Top Stories

Top Stories
GET
https://www.searchapi.io/api/v1/search?engine=google_news_light&q=Olympics
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_news_light",
  "q": "Olympics"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
    "top_stories": [
        {
            "title": "LA28 reveals first version of detailed competition calendar with three years to go until the 2028 Olympic Games",
            "link": "https://www.google.com/url?q=https://www.olympics.com/en/news/la28-reveals-first-version-detailed-competition-calendar-three-years-to-go&sa=U&ved=2ahUKEwj72tGkwb-OAxXOF1kFHcOjE_kQxfQBegQIAxAC&usg=AOvVaw1pU-MRkbr2F1lSFTzDv0bO",
            "source": "Olympics.com",
            "date": "22 hours ago"
        },
        {
            "title": "Cricket at LA Olympics 2028 to start on July 12",
            "link": "https://www.google.com/url?q=https://www.espncricinfo.com/story/cricket-at-la-olympics-2028-to-start-on-july-12-1495397&sa=U&ved=2ahUKEwj72tGkwb-OAxXOF1kFHcOjE_kQxfQBegQIAxAF&usg=AOvVaw3eaeQj6k-LzZawoBM7YgVj",
            "source": "ESPNcricinfo",
            "date": "10 hours ago"
        },
        {
            "title": "LA 2028: Olympic T20 cricket set for early start as tournament structure agreed",
            "link": "https://www.google.com/url?q=https://www.bbc.com/sport/cricket/articles/cddzp9qeq4vo&sa=U&ved=2ahUKEwj72tGkwb-OAxXOF1kFHcOjE_kQxfQBegQIAxAI&usg=AOvVaw03P9FcDd_zbL5BD7IOP7py",
            "source": "BBC",
            "date": "1 hour ago"
        },
        ...
    ]
}