Google Forums API Documentation
Use the Google Forums API to extract real-time discussions from forums and community platforms indexed by Google, including Reddit, Stack Exchange, vendor support forums, and niche communities. Query any topic and receive normalized results with titles, links, domains, snippets, favicons, sitelinks, dates, and answer/comment counts-returned in structured JSON.
API Parameters
Search Query
-
- Name
-
q
- Required
- Required
- Description
-
This parameter is used for the terms you want to search on Google Forums. Queries can include operators and advanced filters like "machine learning models",
site:
,inurl:
,intitle:
,AND
, orOR
.
Device
-
- Name
-
device
- Required
- Optional
- Description
-
The default parameter
desktop
defines the search on a desktop device. Themobile
parameter defines the search on a mobile device. Thetablet
parameter defines the search on a tablet device.
Geographic Location
-
- Name
-
location
- Required
- Optional
- Description
-
This parameter is used to specify the canonical location of the search. For exact targeting or to see all available options, check out the Locations API. If multiple locations match your input, the most popular one will be selected. For example -
location=New York
would selectNew York,United States
orlocation=London
would selectLondon TV Region,England,United Kingdom
.
-
- Name
-
uule
- Required
- Optional
- Description
-
This parameter sets the exact Google-encoded location for the search, and
uule
andlocation
cannot be used at the same time. SearchApi builds it for you when you use thelocation
parameter, but you can provide your own if you want precise control.
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 Googlegoogle_domain
domains.
-
- Name
-
gl
- Required
- Optional
- Description
-
The default parameter
us
defines the country of the search. Check the full list of supported Googlegl
countries.
-
- Name
-
hl
- Required
- Optional
- Description
-
The default parameter
en
defines the interface language of the search. Check the full list of supported Googlehl
languages.
-
- Name
-
lr
- Required
- Optional
- Description
-
The lr parameter restricts search results to documents written in a particular language or a set of languages. The accepted format for this parameter is
lang_{2-letter country code}
. For instance, to filter documents written in Japanese, the value should be set tolang_jp
. To incorporate multiple languages, a value likelang_it|lang_de
restricts the search to documents written in either Italian or German. Google identifies the document language based on the top-level domain (TLD) of the document's URL, any language meta tags present, or the language utilized within the document's body text. Check the full list of supported Googlelr
languages.
-
- Name
-
cr
- Required
- Optional
- Description
-
The cr parameter restricts search results to documents originating in a particular country. Google determines the country of a document by the top-level domain (TLD) of the document's URL or by Web server's IP address geographic location. Check the full list of supported Google
cr
countries.
-
- Name
-
verbatim
- Required
- Optional
- Description
-
The verbatim parameter controls whether the search results are returned in the exact order of the query. By default, the value is
false
. To return the results in the exact order of the query, set the value totrue
.
Filters
-
- 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 is0
, 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 to0
.
-
- 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 tooff
. By default, SafeSearch is disabled.
-
- 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.- Using
time_period_min
ortime_period_max
parameters, you can specify a custom time period.
time_period_min
andtime_period_max
parameters could be used separately as well.
-
- Name
-
time_period_min
- Required
- Optional
- Description
-
This parameter specifies the start of the time period. It could be used in combination with the
time_period_max
parameter. The value should be in the formatMM/DD/YYYY
.
-
- Name
-
time_period_max
- Required
- Optional
- Description
-
This parameter specifies the end of the time period. It could be used in combination with the
time_period_min
parameter. The value should be in the formatMM/DD/YYYY
.
Pagination
-
- 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_forums
.
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

https://www.searchapi.io/api/v1/search?engine=google_forums&q=ChatGPT
- 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_forums",
"q": "ChatGPT"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_vxbn58j7pJdLFlA0oDeN0V2d",
"status": "Success",
"created_at": "2025-10-11T14:44:23Z",
"request_time_taken": 1.74,
"parsing_time_taken": 0.07,
"total_time_taken": 1.81,
"request_url": "https://www.google.com/search?q=ChatGPT&oq=ChatGPT&gl=us&hl=en&udm=18&tbs=&ie=UTF-8",
"html_url": "https://www.searchapi.io/api/v1/searches/search_vxbn58j7pJdLFlA0oDeN0V2d.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_vxbn58j7pJdLFlA0oDeN0V2d"
},
"search_parameters": {
"engine": "google_forums",
"q": "ChatGPT",
"device": "desktop",
"google_domain": "google.com",
"hl": "en",
"gl": "us"
},
"search_information": {
"query_displayed": "ChatGPT",
"total_results": 57300000,
"time_taken_displayed": 0.23,
"detected_location": "Wisconsin",
"has_no_results_for": false
},
"organic_results": [
{
"position": 1,
"title": "Catastrophic Failures of ChatGpt that's creating major ...",
"link": "https://community.openai.com/t/catastrophic-failures-of-chatgpt-thats-creating-major-problems-for-users/1156230",
"source": "OpenAI Developer Community",
"domain": "community.openai.com",
"displayed_link": "https://community.openai.com › ChatGPT › Bugs",
"snippet": "On February 5, 2025, a catastrophic and unannounced update to the ChatGPT memory system caused a mass erasure and fragmentation of user memory ...",
"snippet_highlighted_words": ["ChatGPT"],
"date": "Mar 29, 2025",
"favicon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAMAAABF0y+mAAAANlBMVEVHcEwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAR2LVAAAAEnRSTlMAMl9AAyD0/9sPtcR1T4fnm6c/PlxQAAAAx0lEQVR4AcXRQW7FIBAE0QIGGjAGfP/LJiiShdBXdlHetqZXwz9zPvCZxaQshegKnIo8UKWkyzhcDVxKAazqaE1mVQ3uArmzsTREEMQsdUJic1VEGEzN1Zu2FoWtpWqVh1v70uef6MBpOMiT1z0wFTcAxlSlyN5oinRdGSA5ZIybV09GueTBK5yRpAZu5DFWpKhsUSHrXlvSivlhkwJemhDXUhe7PoACjzpF5+dGdtBU18HDaerbAzbFB4WYpf2bhxKNXxh/7gtSKwah2Mje2wAAAABJRU5ErkJggg=="
},
{
"position": 2,
"title": "After a thorough evaluation of ChatGPT 5, these are my ...",
"link": "https://www.reddit.com/r/OpenAI/comments/1mkkued/after_a_thorough_evaluation_of_chatgpt_5_these/",
"source": "Reddit · r/OpenAI",
"domain": "www.reddit.com",
"displayed_link": "620+ comments · 2 months ago",
"snippet": "ChatGPT-5 is the most frustrating tool I've ever used. It makes big promises but only causes harm. It doesn't remember previous descriptions, is ...",
"snippet_highlighted_words": ["ChatGPT"],
"sitelinks": {
"list": [
{
"title": "is chatgpt still the best ai for general use? : r/OpenAI ...",
"link": "https://www.reddit.com/r/OpenAI/comments/1mcm6su/is_chatgpt_still_the_best_ai_for_general_use/",
"answer_count": 39,
"date": "Jul 29, 2025"
},
{
"title": "Chat GPT 5 was not for use, it was to get rid of free ...",
"link": "https://www.reddit.com/r/ChatGPT/comments/1mlkemm/chat_gpt_5_was_not_for_use_it_was_to_get_rid_of/",
"answer_count": 1028,
"date": "Aug 9, 2025"
}
]
},
"favicon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAMAAABF0y+mAAAAllBMVEVHcEz/RQD/RQD/RQD/RQD/RQD/RQD/RQD/RQD/RQD/RQD/RQD/RgD/RQD+////RQD/PAD/NQD+QgDP3+fb6e7n8PLx9vcKEhX0/f/L1tz+jXL718/+XCr4+vv0e1/olIP6pJDi3N3PqqbfNAn7cU//VgP+9vQyODv1bEb+49rdzc3/v66xu77IXlHlXDhqcHKsLABrLBlRGkQ3AAAADnRSTlMAwkSK1tA47GYdh31HPrF7ujQAAAF5SURBVCiRbZOHcoMwDIahyYUkbW3Z2GbvlT3e/+UqQSCkiY4D5A9bvwaWNdpqYTucO/ZiZf23NYLRnPUL2iyfiEvJl5sn+5khLuJacP41sq85gyNje5joZs7kLWCMhUiHk+fxKu9+YswnuOx1zvd5FZRKHYAc0jzlIAFudwCoU9RLGWHuJEIIABHnx7I85jE6eOHyylqg+DCKwnDPHrYPycd0tpbNIWcfLAduU8hPjDEKymXs07spi2GxKA09/FhyCwNrkzB2FruEFpMqPtO3GgEeC5lKmK4aGRGMRFNplqgM8Fgb1eZ+4l8a3hJseXNBN0e1NqUid9oYE7VDzDYyiTE7San0RSi0Nv6p6zyv606+0boYikC5QOoqpZXXm9JaqRT68vWFh8x1XRVcPe8aKHzN4FH4vmUiDdwgwP10D1JUM7RsaDbw7FDgHrc4ZLzv2GOMfof5gLhO0zoG6Bs2DtH3NHYgh1a+s5lNo7l+Q7OhfoWOvX3+Dn+Ini8glo+XBwAAAABJRU5ErkJggg=="
},
...
],
"related_searches": [
{
"query": "Chatgpt review",
"link": "https://www.google.com/search?sca_esv=9e6dc345315a8504&udm=18&hl=en&gl=us&q=Chatgpt+review&sa=X&ved=2ahUKEwi5sdaQsZyQAxUZTTABHdrKLRIQ1QJ6BAg-EAE"
},
{
"query": "What happened to ChatGPT today",
"link": "https://www.google.com/search?sca_esv=9e6dc345315a8504&udm=18&hl=en&gl=us&q=What+happened+to+ChatGPT+today&sa=X&ved=2ahUKEwi5sdaQsZyQAxUZTTABHdrKLRIQ1QJ6BAhEEAE"
},
...
],
"pagination": {
"current": 1,
"next": "https://www.google.com/search?q=ChatGPT&oq=ChatGPT&gl=us&hl=en&start=10&udm=18&tbs=&ie=UTF-8"
}
}