Google News Portal API
The Google News Portal API provides access to Google News content, enabling developers to retrieve news stories, browse topics, explore publications, and access full coverage from diverse sources worldwide. This API offers structured data for front page headlines, topic-based browsing with hierarchical navigation, publication-specific content, and detailed story coverage with multiple perspectives. You can search for news content, navigate through topic sections, access specific publications, and retrieve full coverage stories using unique tokens for precise content targeting.
API Parameters
Search Query
-
- Name
-
q - Required
- Optional
- Description
-
This parameter is used for the terms you want to search on Google News Portal.
Note: Cannot be used together withstory_token,publication_token, andtopic_tokenparameters.
Localization
-
- Name
-
ceid - Required
- Optional
- Description
-
The parameter defines the country and language of the news. The default value is
US:en. Check the full list of supported Google News Portalceidcountries and languages.
Filters
-
- Name
-
story_token - Required
- Optional
- Description
-
Parameter defines the story that is used to access full coverage of a specific story. The token can be found in the JSON response or in the URL of the page (the string after the
/stories/in the URL path).
Note: Cannot be used together with theq,publication_token, andtopic_tokenparameters.
-
- Name
-
sort_by - Required
- Optional
- Description
-
Parameter defines the sorting order for full coverage results. Valid values are
relevance(default) anddate. When set todate, articles are sorted by publication time with newest first.
Note: Can only be used with thestory_tokenparameter to sort articles within a specific story's full coverage.
-
- Name
-
publication_token - Required
- Optional
- Description
-
Parameter defines the publication token that is used to access the specific publisher news. The token can be found in the JSON response or in the URL of the page (the string after the
/publications/in the URL path).
Note: Cannot be used together with theq,story_token, andtopic_tokenparameters.
-
- Name
-
topic_token - Required
- Optional
- Description
-
Parameter defines the topic token that is used to access the specific topic news. The token can be found in the JSON response or in the URL of the page (the string after the
/topics/in the URL path).
Note: Cannot be used together with theq,story_token, andpublication_tokenparameters.
-
- Name
-
section_token - Required
- Optional
- Description
-
Parameter for accessing subsections within a Google News topic. Topics can have multiple sections (e.g., the "Technology" topic has sections like "AI", "Cybersecurity", "Gadgets"). The token identifies which section to retrieve and can be found in the JSON response or after
/sections/in the URL.
Note: Requirestopic_tokenparameter since sections exist only within topics.
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_portal.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates 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
trueto 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
Front Page
https://www.searchapi.io/api/v1/search?engine=google_news_portal
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_news_portal"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_6EB5K71e3vjbf5E63vXNW82V",
"status": "Success",
"created_at": "2025-07-08T06:27:55Z",
"request_time_taken": 1.81,
"parsing_time_taken": 0.04,
"total_time_taken": 1.85,
"request_url": "https://news.google.com/home?hl=en-US&gl=US&ceid=US:en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_6EB5K71e3vjbf5E63vXNW82V.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_6EB5K71e3vjbf5E63vXNW82V"
},
"search_parameters": {
"engine": "google_news_portal",
"ceid": "US:en"
},
"organic_results": [
{
"position": 1,
"story_token": "CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2k4dFlQd0RoSFFaQUI1RHpKbGJTZ0FQAQ",
"title": "Trump escalates trade war with Canada following Palestine stance",
"link": "https://www.reuters.com/world/americas/trump-escalates-trade-war-with-canada-following-palestine-stance-2025-07-31/",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSoBQrBIDm-A7cl7MGs21YWRXCIwZCJF185PS75T7PiL7_xFvNbEwikzAXLZv6JkoLy4m0izjbYzJB4-A",
"iso_date": "2025-07-31T10:47:26Z",
"source": {
"name": "Reuters",
"favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.reuters.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"authors": [
"Bernadette Baum",
"Gnaneshwar Rajan",
"Kate Mayberry"
]
}
},
...
{
"position": 9,
"story_token": "CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2pJbHRYVERoSEY5T2toWDJQbzB5Z0FQAQ",
"title": "Amid Scramble for Food, Prices in Gaza Reach Extraordinary Heights",
"link": "https://www.nytimes.com/2025/07/31/world/middleeast/gaza-market-prices-flour.html",
"thumbnail": "https://news.google.com/api/attachments/CC8iK0NnNTFYekExV1RCeFEyeGZaR1UyVFJDUUF4allCQ2dLTWdZQllKVHBzUWM=-w100-h100-p-df-rw",
"iso_date": "2025-07-31T11:40:03Z",
"source": {
"name": "The New York Times",
"favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.nytimes.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"authors": [
"Adam Rasgon",
"Ashley Wu"
]
}
},
...
],
"menu_topics": [
{
"title": "U.S.",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE"
},
...
],
"related_topics": [
{
"title": "Top stories",
"topic_token": "CAAqJggKIiBDQkFTRWdvSUwyMHZNRFZxYUdjU0FtVnVHZ0pWVXlnQVAB"
}
]
}
Search Results with Related Publications and Topics
https://www.searchapi.io/api/v1/search?engine=google_news_portal&q=bbc
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_news_portal",
"q": "bbc"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_MZGK9PqJ3jK6hW18pBj1zdOm",
"status": "Success",
"created_at": "2025-07-08T06:27:55Z",
"request_time_taken": 1.81,
"parsing_time_taken": 0.03,
"total_time_taken": 1.83,
"request_url": "https://news.google.com/search?q=bbc&hl=en-US&gl=US&ceid=US:en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_MZGK9PqJ3jK6hW18pBj1zdOm.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_MZGK9PqJ3jK6hW18pBj1zdOm"
},
"search_parameters": {
"engine": "google_news_portal",
"q": "bbc",
"ceid": "US:en"
},
"organic_results": [
{
"position": 1,
"title": "Texas floods: 91 dead and dozens missing as more rain looms",
"link": "https://www.bbc.com/news/articles/cddzrj323zzo",
"thumbnail": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcS43y96rpqpF8aoQnPRQABx37fJHiCzRkoEE_bRzanOCUfE9A8kh_HUKK-Zo8dR-rGeZ1O1xjW5EJc-",
"iso_date": "2025-07-07T20:47:07Z",
"source": {
"name": "BBC",
"favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.bbc.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"authors": [
"Gary O'Donoghue"
]
}
},
...
],
"menu_topics": [
{
"title": "U.S.",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE"
},
...
],
"related_publications": [
{
"title": "BBC Wildlife Magazine",
"publication_token": "CAAqMQgKIitDQklTR2dnTWFoWUtGR1JwYzJOdmRtVnlkMmxzWkd4cFptVXVZMjl0S0FBUAE"
}
],
"related_topics": [
{
"title": "BBC One",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNREZtTW5jd0VnSmxiaWdBUAE"
},
...
]
}
Search Results with Stories
https://www.searchapi.io/api/v1/search?engine=google_news_portal&q=brad+pitt
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_news_portal",
"q": "brad pitt"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_Rrb28K9xoXv9ce65pzE1BA7Q",
"status": "Success",
"created_at": "2025-07-08T06:27:55Z",
"request_time_taken": 1.84,
"parsing_time_taken": 0.02,
"total_time_taken": 1.86,
"request_url": "https://news.google.com/search?q=brad+pitt&hl=en-US&gl=US&ceid=US:en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_Rrb28K9xoXv9ce65pzE1BA7Q.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_Rrb28K9xoXv9ce65pzE1BA7Q"
},
"search_parameters": {
"engine": "google_news_portal",
"q": "brad pitt",
"ceid": "US:en"
},
"organic_results": [
{
"position": 1,
"story_title": "Apple's new film F1 scores big at box office",
"story_token": "CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2kyajViSkRoRU42NE9zVHRHQS1TZ0FQAQ",
"title": "Apple races to box office glory with Brad Pitt’s F1 blockbuster",
"link": "https://www.ft.com/content/fe5a2104-e56f-48a7-9aab-a61f413f780a",
"thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQcQJxQe9DMiYSjaqlistkSXwlK5x9g8eeG4Fx1xnIzA5_ZyfUmpLfdvWjSWiIfrvj1yj0&fopt=w64-h64-rw-dcuROGUZEK",
"iso_date": "2025-07-05T04:01:01Z",
"source": {
"name": "Financial Times",
"favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.ft.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"authors": [
"Daniel Thomas & Christopher Grimes"
]
}
},
...
],
"menu_topics": [
{
"title": "U.S.",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE"
},
...
],
"related_topics": [
{
"title": "Brad Pitt",
"topic_token": "CAAqIQgKIhtDQkFTRGdvSUwyMHZNR00yY1dnU0FtVnVLQUFQAQ"
},
...
]
}
Topic
https://www.searchapi.io/api/v1/search?engine=google_news_portal&topic_token=CAAqIQgKIhtDQkFTRGdvSUwyMHZNR00yY1dnU0FtVnVLQUFQAQ
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_news_portal",
"topic_token": "CAAqIQgKIhtDQkFTRGdvSUwyMHZNR00yY1dnU0FtVnVLQUFQAQ"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_n9XmVeqAp1RdHX9KgKkGJZrx",
"status": "Success",
"created_at": "2025-07-08T06:27:55Z",
"request_time_taken": 1.77,
"parsing_time_taken": 0.03,
"total_time_taken": 1.81,
"request_url": "https://news.google.com/search?topic_token=CAAqIQgKIhtDQkFTRGdvSUwyMHZNR00yY1dnU0FtVnVLQUFQAQ&hl=en-US&gl=US&ceid=US:en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_n9XmVeqAp1RdHX9KgKkGJZrx.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_n9XmVeqAp1RdHX9KgKkGJZrx"
},
"search_parameters": {
"engine": "google_news_portal",
"topic_token": "CAAqIQgKIhtDQkFTRGdvSUwyMHZNR00yY1dnU0FtVnVLQUFQAQ",
"ceid": "US:en"
},
"organic_results": [
{
"position": 1,
"title": "Opinion | God Bless Brad Pitt",
"link": "https://www.nytimes.com/2025/07/05/opinion/brad-pitt-f1.html",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ4cwfDy91mlxStOgadvAQzOHpAZVQNxYduAK2lKS21FONwhg7ZTo8ppJVKvtmPtJjTKpU&fopt=w200-h112-rw-dcHWWQ66kH",
"iso_date": "2025-07-05T11:00:19Z",
"source": {
"name": "The New York Times",
"favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.nytimes.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"authors": [
"Bruce Handy"
]
}
},
{
"position": 2,
"story_token": "CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2k4OXZfSERoRzZWcVRwNUw1QVR5Z0FQAQ",
"title": "Why Brad Pitt and Tom Cruise's 'Ford v Ferrari' Movie Failed",
"link": "https://variety.com/2025/film/news/brad-pitt-tom-cruise-ford-v-ferrari-movie-failed-1236446786/",
"thumbnail": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQHjbiC_nbjsAtgo15kWZ1NMIptNM2QrwWeCgfd36LpQpmWBS2aHpx3mvX8fYus3Rf3HPQ&fopt=w280-h168-rw-dcoTOaSyEJ",
"iso_date": "2025-07-03T20:10:00Z",
"source": {
"name": "Variety",
"favicon": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://variety.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"authors": [
"Zack Sharf"
]
}
},
...
],
"menu_topics": [
{
"title": "U.S.",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE"
},
...
]
}
Topic with Sub Menu
https://www.searchapi.io/api/v1/search?engine=google_news_portal&topic_token=CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_news_portal",
"topic_token": "CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_8qWVwGvboYPYTxevgmDQJaN4",
"status": "Success",
"created_at": "2025-07-08T06:27:55Z",
"request_time_taken": 1.9,
"parsing_time_taken": 0.04,
"total_time_taken": 1.94,
"request_url": "https://news.google.com/search?topic_token=CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB&hl=en-US&gl=US&ceid=US:en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_8qWVwGvboYPYTxevgmDQJaN4.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_8qWVwGvboYPYTxevgmDQJaN4"
},
"search_parameters": {
"engine": "google_news_portal",
"topic_token": "CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB",
"ceid": "US:en"
},
"organic_results": [
...
],
"menu_topics": [
{
"title": "U.S.",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE"
},
...
],
"sub_menu_sections": [
{
"title": "Mobile",
"section_token": "CAQiYkNCQVNRd29JTDIwdk1EZGpNWFlTQW1WdUdnSlZVeUlPQ0FRYUNnb0lMMjB2TURVd2F6Z3FId29kQ2hsTlQwSkpURVZmVUVoUFRrVmZVMFZEVkVsUFRsOU9RVTFGSUFFb0FBKioIAComCAoiIENCQVNFZ29JTDIwdk1EZGpNWFlTQW1WdUdnSlZVeWdBUAFQAQ",
"topic_token": "CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB"
},
...
]
}
Topic Section
https://www.searchapi.io/api/v1/search?engine=google_news_portal§ion_token=CAQiQ0NCQVNMQW9JTDIwdk1EZGpNWFlTQW1WdUdnSlZVeUlOQ0FRYUNRb0hMMjB2TUcxcmVpb0pFZ2N2YlM4d2JXdDZLQUEqKggAKiYICiIgQ0JBU0Vnb0lMMjB2TURkak1YWVNBbVZ1R2dKVlV5Z0FQAVAB&topic_token=CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_news_portal",
"topic_token": "CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB",
"section_token": "CAQiQ0NCQVNMQW9JTDIwdk1EZGpNWFlTQW1WdUdnSlZVeUlOQ0FRYUNRb0hMMjB2TUcxcmVpb0pFZ2N2YlM4d2JXdDZLQUEqKggAKiYICiIgQ0JBU0Vnb0lMMjB2TURkak1YWVNBbVZ1R2dKVlV5Z0FQAVAB"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_V6QeGdKRg9qesPZ2g8mBExyv",
"status": "Success",
"created_at": "2025-07-08T06:27:55Z",
"request_time_taken": 1.78,
"parsing_time_taken": 0.03,
"total_time_taken": 1.81,
"request_url": "https://news.google.com/search?topic_token=CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB§ion_tokne=CAQiQ0NCQVNMQW9JTDIwdk1EZGpNWFlTQW1WdUdnSlZVeUlOQ0FRYUNRb0hMMjB2TUcxcmVpb0pFZ2N2YlM4d2JXdDZLQUEqKggAKiYICiIgQ0JBU0Vnb0lMMjB2TURkak1YWVNBbVZ1R2dKVlV5Z0FQAVAB&hl=en-US&gl=US&ceid=US:en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_V6QeGdKRg9qesPZ2g8mBExyv.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_V6QeGdKRg9qesPZ2g8mBExyv"
},
"search_parameters": {
"engine": "google_news_portal",
"topic_token": "CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB",
"section_token": "CAQiQ0NCQVNMQW9JTDIwdk1EZGpNWFlTQW1WdUdnSlZVeUlOQ0FRYUNRb0hMMjB2TUcxcmVpb0pFZ2N2YlM4d2JXdDZLQUEqKggAKiYICiIgQ0JBU0Vnb0lMMjB2TURkak1YWVNBbVZ1R2dKVlV5Z0FQAVAB",
"ceid": "US:en"
},
"organic_results": [
{
"position": 1,
"story_token": "CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2pxeDZyRkRoSHl4MGsxN2hvZHh5Z0FQAQ",
"title": "Apple Loses Top AI Models Executive to Meta’s Hiring Spree",
"link": "https://www.bloomberg.com/news/articles/2025-07-07/apple-loses-its-top-ai-models-executive-to-meta-s-hiring-spree",
"thumbnail": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcQnG5I1QWdGEW_TRjcOgf7hZh1fG24VUX0zo1G0kMzXjZ0lNR_fuWWqVALMjEvg9F-zmFI&fopt=w280-h168-rw-dcIUQM",
"iso_date": "2025-07-08T02:11:00Z",
"source": {
"name": "Bloomberg",
"favicon": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://www.bloomberg.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"authors": [
"Mark Gurman"
]
}
},
{
"position": 2,
"story_token": "CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2pxeDZyRkRoSHl4MGsxN2hvZHh5Z0FQAQ",
"title": "Apple's top AI executive Ruoming Pang leaves for Meta, Bloomberg News reports",
"link": "https://finance.yahoo.com/news/apples-top-ai-executive-ruoming-224044121.html",
"iso_date": "2025-07-07T22:40:44Z",
"source": {
"name": "Yahoo Finance",
"favicon": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://finance.yahoo.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
}
},
...
],
"menu_topics": [
{
"title": "U.S.",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE"
},
...
],
"sub_menu_sections": [
{
"title": "Mobile",
"section_token": "CAQiYkNCQVNRd29JTDIwdk1EZGpNWFlTQW1WdUdnSlZVeUlPQ0FRYUNnb0lMMjB2TURVd2F6Z3FId29kQ2hsTlQwSkpURVZmVUVoUFRrVmZVMFZEVkVsUFRsOU9RVTFGSUFFb0FBKioIAComCAoiIENCQVNFZ29JTDIwdk1EZGpNWFlTQW1WdUdnSlZVeWdBUAFQAQ",
"topic_token": "CAAqJggKIiBDQkFTRWdvSUwyMHZNRGRqTVhZU0FtVnVHZ0pWVXlnQVAB"
},
...
]
}
Full Coverage (Story)
https://www.searchapi.io/api/v1/search?engine=google_news_portal&story_token=CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2kyajViSkRoRU42NE9zVHRHQS1TZ0FQAQ
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_news_portal",
"story_token": "CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2kyajViSkRoRU42NE9zVHRHQS1TZ0FQAQ"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_RqXLK4ZloPW8iwMPgxM8z2jE",
"status": "Success",
"created_at": "2025-07-08T06:27:55Z",
"request_time_taken": 1.56,
"parsing_time_taken": 0.03,
"total_time_taken": 1.6,
"request_url": "https://news.google.com/search?story_token=CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2kyajViSkRoRU42NE9zVHRHQS1TZ0FQAQ&hl=en-US&gl=US&ceid=US:en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_RqXLK4ZloPW8iwMPgxM8z2jE.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_RqXLK4ZloPW8iwMPgxM8z2jE"
},
"search_parameters": {
"engine": "google_news_portal",
"story_token": "CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2kyajViSkRoRU42NE9zVHRHQS1TZ0FQAQ",
"ceid": "US:en"
},
"organic_results": [
{
"position": 1,
"section": "Top news",
"title": "Apple races to box office glory with Brad Pitt’s F1 blockbuster",
"link": "https://www.ft.com/content/fe5a2104-e56f-48a7-9aab-a61f413f780a",
"thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcTQ07iRTAEZLOJjYGN5C08TpaNcUWYPPvnEsSmkwCajbVRGrxEh181O30QRwsw8HQo4V5ildLkUQoU",
"iso_date": "2025-07-05T04:01:01Z",
"source": {
"name": "Financial Times",
"favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.ft.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"authors": [
"Daniel Thomas & Christopher Grimes"
]
}
},
...
{
"position": 4,
"section": "Opinion",
...
},
{
"position": 8,
"title": "Apple’s F1 Hits $237 Million Globally – AAPL Climbs 6% on Box Office Momentum",
"link": "https://www.tipranks.com/news/apples-f1-hits-300-million-globally-aapl-climbs-6-on-box-office-momentum",
"thumbnail": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcTBujEU-9_ZaolsKG3kOL3AKPvGsROv2Vn5er3Jqn1HZT4BH9_245_lKnikBxDPfvRGmcw&fopt=w100-h100-rw-dcAQCBx~AA",
"iso_date": "2025-07-06T09:46:46Z",
"source": {
"name": "TipRanks",
"favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.tipranks.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"authors": [
"Ran Melamed"
]
}
},
...
],
"posts_on_x": [
{
"position": 1,
"snippet": "#F1 just raced past $300M at global #boxoffice and is on track to surpass $400M and $500M barriers too! #F1TheMovie",
"link": "https://x.com/GiteshPandya/status/1942346615907573887",
"iso_date": "2025-07-07T22:14:54Z",
"author": {
"name": "Gitesh Pandya (TikTok @gitesh.pandya)",
"handle": "GiteshPandya",
"thumbnail": "https://pbs.twimg.com/profile_images/1330475442/Glove_normal.jpg"
}
},
...
],
"frequently_asked_questions": [
{
"position": 1,
"title": "How did F1 the movie do at the box office?",
"snippet": "The film landed in theaters in late June with $57 million domestically and $146 million worldwide, easily handing Apple its biggest opening weekend to iso_date.",
"link": "https://variety.com/2025/film/box-office/f1-movie-apple-highest-grossing-film-napoleon-1236448149/",
"iso_date": "2025-07-06T18:07:00Z",
"source": {
"title": "‘F1’ Overtakes ‘Napoleon’ as Apple’s Highest-Grossing Film With $293 Million",
"name": "Variety",
"favicon": "https://encrypted-tbn1.gstatic.com/faviconV2?url=https://variety.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
}
},
...
],
"menu_topics": [
{
"title": "U.S.",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE"
},
...
]
}
Publication
https://www.searchapi.io/api/v1/search?engine=google_news_portal&publication_token=CAAqIAgKIhpDQklTRFFnTWFna0tCMk51Ymk1amIyMG9BQVAB
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_news_portal",
"publication_token": "CAAqIAgKIhpDQklTRFFnTWFna0tCMk51Ymk1amIyMG9BQVAB"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_0E6M9wDPgb74Hl18oRnqybBA",
"status": "Success",
"created_at": "2025-07-08T06:27:55Z",
"request_time_taken": 1.16,
"parsing_time_taken": 0.04,
"total_time_taken": 1.2,
"request_url": "https://news.google.com/search?publication_token=CAAqIAgKIhpDQklTRFFnTWFna0tCMk51Ymk1amIyMG9BQVAB&hl=en-US&gl=US&ceid=US:en",
"html_url": "https://www.searchapi.io/api/v1/searches/search_0E6M9wDPgb74Hl18oRnqybBA.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_0E6M9wDPgb74Hl18oRnqybBA"
},
"search_parameters": {
"engine": "google_news_portal",
"publication_token": "CAAqIAgKIhpDQklTRFFnTWFna0tCMk51Ymk1amIyMG9BQVAB",
"ceid": "US:en"
},
"organic_results": [
{
"position": 1,
"title": "Trump announces new tariffs of up to 40% on a growing number of countries",
"link": "https://edition.cnn.com/2025/07/07/economy/trump-letters-tariffs",
"thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQZxbDNR-XakicIrD60YMkA3C-KYoKWnRr7aJEXMjWXeE5ILs2kPnGldMDSaPTtvd5LkMYXfPLTT4IO",
"iso_date": "2025-07-08T02:44:00Z",
"source": {
"authors": [
"Elisabeth Buchwald"
]
}
},
...
],
"menu_topics": [
{
"title": "U.S.",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE"
},
...
]
}