Google Forums API
Extract forum threads, Q&A, and community discussions from Google Search’s "Forums" tab. Supports 40+ countries, custom localization (GL/HL), and pagination. Get structured JSON data from Reddit, LinkedIn, Quora, and niche forums for sentiment analysis, market research, or AI training.
Input parameters
| PARAMETER | TYPE | REQ | DEFAULT | DESCRIPTION |
|---|---|---|---|---|
| q | string | yes | — | Provide the search query for forum discussions (e.g. 'what is the best programming language', 'python vs java', 'best coffee brewing methods'). |
| location | string | no | — | Set a geographic location string for localized forum results (e.g. 'Austin, TX, Texas, United States', 'New York, NY'). |
| device | enum | no | desktop | Choose the device type to emulate for the Google Forums search. |
| gl | enum | no | — | Set the country code for localization (ISO 3166-1 alpha-2, lowercase). |
| hl | enum | no | — | Set the interface language code for localization (ISO 639-1 base codes, lowercase). |
| lr | string | no | — | Restrict results to a specific language (e.g. 'lang_en', 'lang_es', 'lang_fr'). |
| safe | enum | no | off | Toggle safe search to filter explicit content. |
| nfpr | enum | no | 0 | Exclude results from auto-corrected queries when the original query is misspelled. |
| filter | enum | no | 0 | Toggle duplicate content filtering. |
| max_pages | integer | no | 1 | Set the maximum number of result pages to fetch. — drives your bill |
Worked examples
{
"q": "what is the best programming language"
}
Coverage
Code
curl
curl -X POST "https://api.apify.com/v2/acts/johnvc~google-forums-search-api/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"q": "what is the best programming language"}'
Python
from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/google-forums-search-api").call(
run_input={'q': 'what is the best programming language'}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
MCP
Apify's hosted MCP server loads this source from the URL below as the tool johnvc--google-forums-search-api. Sign in to Apify when your client asks (OAuth), or send an Apify token as an Authorization: Bearer header.
https://mcp.apify.com/?tools=johnvc/google-forums-search-api
Questions people ask
What does the Google Forums API return?
It returns forum threads, Q&A and community discussions from the Forums tab of Google Search as structured JSON, drawing on Reddit, Quora, LinkedIn and niche boards.
How much does the Google Forums API cost per page?
The default Pay per page edition bills 0.019999 USD per results page processed. max_pages defaults to 1 and is the main cost control, and there is a free tier on Apify.
Which countries and languages does the Google Forums API support?
It supports 52 country codes via gl, including us, gb, ca and au, and 41 interface language codes via hl such as en, es, fr, de and it. The lr input further restricts results to one language.
What inputs does the Google Forums API take?
Only q, the search query, is required. Optional inputs include location, device, which defaults to desktop, gl, hl, lr, safe search, nfpr to exclude auto-corrected queries, duplicate filtering and max_pages.
Can an AI agent use the Google Forums API for research?
Yes. The source is exposed as an MCP tool on Apify's hosted MCP server for Claude, Cursor and other agents, and over REST, which suits sentiment analysis, market research and AI training pipelines.