# Google Forums Search

Search forum discussions from Google's Forums tab (Reddit, Facebook groups, Stack Exchange, Home-Barista.com and similar communities). Every result carries its community, comment and answer counts, relative age, and - where Google serves them - the answer sitelinks of that thread. Related searches and pagination come from the same result page, so one request returns the full picture. Requests that fail upstream are never charged; a valid empty result page is a successful, charged request.

- **Documentation:** [https://scrappa.co/docs/google-forums-api/google_forums](https://scrappa.co/docs/google-forums-api/google_forums)
- **API group:** Google Forums API
- **Endpoint:** `GET https://scrappa.co/api/google-forums/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | The search query (e.g. best coffee grinder). Sent to Google as q. |
| `hl` | string | No | 2-letter interface language code (e.g. en, de) |
| `gl` | string | No | 2-letter country code (e.g. us, de) |
| `google_domain` | string | No | Google host for the request (e.g. www.google.com, www.google.de) |
| `start` | integer | No | 0-indexed result offset, step 10 (e.g. 0, 10, 90, 200) |
| `page` | integer | No | 0-based page number, translated to start = page * 10 when start is absent |
| `num` | integer | No | Accepted and validated (1-100) but ignored upstream: Google returns exactly 10 results per Forums page. The response reports the real count in organic_results_count. |
| `no_cache` | boolean | No | Boolean. true always fetches upstream and never reads or writes the result cache. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Invalid characters in a parameter |  |
|  | The upstream service is temporarily unavailable. Please retry shortly. |  |
|  | The Forums search could not return a valid result page |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)