# Google Forums API

> Get Google's Forums results for a query: discussion threads from Reddit, Quora and other forums with title, snippet, source and answer counts.

Source: https://www.sandbase.ai/apis/google/forums
API reference: https://www.sandbase.ai/apis/google/forums#api

## Facts

- Provider: Google
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/google/forums`
- Price: $0.01 per call
- Capabilities: api, google, web search, serp
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/google/forums` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `q` | string | yes |  |
| `location` | string | no |  |
| `uule` | string | no |  |
| `gl` | string | no |  |
| `hl` | string | no |  |
| `period_unit` | string | no | s, n, h, d, w, m, y |
| `period_value` | string | no |  |
| `start_date` | string | no |  |
| `end_date` | string | no |  |
| `start` | string | no |  |
| `nfpr` | string | no |  |
| `filter` | string | no |  |
| `tbs` | string | no |  |
| `device` | string | no |  |
| `json_restrictor` | string | no |  |

## FAQ

### How do I use the Google Forums API?

Send a POST request to https://api.sandbase.ai/v1/api/google/forums with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Google Forums API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Google Forums API accept?

Required: q (string). Optional: location (string), uule (string), gl (string), hl (string), period_unit (one of s, n, h, d, w, m, y) and period_value (string) and 8 more. The Parameters table and the Playground on this page list every field.

### What does the Google Forums API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Google developer account or API key?

No. Google Forums runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Google API access separately.

## README

### Google Forums

Get Google's Forums results for a query: discussion threads from Reddit, Quora and other forums with title, snippet, source and answer counts.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/google/forums" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "best budget mechanical keyboard"}'
```

The result is returned in `outputs[0].data` as structured JSON.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `q` | string | Yes | Parameter defines the query you want to search. To search for events in a specific location, just include the location inside your search query (e.g. `Events in Austin, TX`). |
| `location` | string | No | 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.json API if you need more precise control. The `location` and `uule` p |
| `uule` | string | No | Parameter is the Google encoded location you want to use for the search. `uule` and `location` parameters can't be used together. For consistent results with coordinates-based `uule` parameter, a matching `gl` parameter is required. Head to |
| `gl` | string | No | Parameter defines the country to use for the Google Forums search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France). Head to the Google countries page for a full list of support |
| `hl` | string | No | Parameter defines the language to use for the Google Forums search. It's a two or three-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French), optionally followed by a two-letter or three-digit region code (e. |
| `period_unit` | string | No | Parameter defines the time period unit to search for the recent images, e.g. from past minute, hour, day etc. Options: `s` - Second `n` - Minute `h` - Hour `d` - Day `w` - Week `m` - Month `y` - Year This parameter can't be used with `start |
| `period_value` | string | No | Parameter defines an optional time period value that can be used with `period_unit` to describe time periods like `15 seconds`, `42 hours`, `178 days` etc. Default value: `1` Value range: `1..2147483647` |
| `start_date` | string | No | Parameter defines the start date of time period you want to limit the image search to. Format: `YYYYMMDD` Example: `20251201` This parameter can't be used with `period_unit`/`period_value` parameters. `start_date` with blank `end_date` prod |
| `end_date` | string | No | Parameter defines the end date of time period you want to limit the image search to. Format: `YYYYMMDD` Example: `20251231` This parameter can't be used with `period_unit`/`period_value` parameters. `end_date` with blank `start_date` produc |
| `start` | string | No | Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., `0` (default) is the first page of results, `10` is the 2nd page of results, `20` is the 3rd page of results, etc.). |
| `nfpr` | string | No | Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. It can be set to `1` to exclude these results, or `0` to include them (default). Note that this parameter may not prevent Goog |
| `filter` | string | No | Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to `1` (default) to enable these filters, or `0` to disable these filters. |
| `tbs` | string | No | (to be searched) parameter defines advanced search parameters that aren't possible in the regular query field. (e.g., advanced search for dates, time period, etc.). |
| `device` | string | No | Parameter defines the device to use to get the results. It can be set to `desktop` (default) to use a regular browser, `tablet` to use a tablet browser (currently using iPads), or `mobile` to use a mobile browser. |
| `json_restrictor` | string | No | Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |

#### Pricing

$0.010 per successful call. Failed calls are not charged.
