> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Trends

> Read a Google Trends explore page with search terms in q as JSON with the google-trends parser. $1 per 1,000 calls. Send the page to scrape.

Reads a Google Trends explore page with search terms in q, or the trending now page, and returns its data as JSON.

## Make a request

Send the page's URL to [scrape](https://docs.stophy.dev/api-reference/endpoint/scrape.md) with a `json` format that names the parser. Get an API key in the [Quickstart](https://docs.stophy.dev/quickstart).

```bash cURL theme={null}
curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://trends.google.com/trends/explore?q=bitcoin&geo=US&date=today%2012-m","formats":[{"type":"json","parser":"google-trends"}]}'
```

```typescript TypeScript theme={null}
const response = await fetch("https://api.stophy.dev/v1/scrape", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://trends.google.com/trends/explore?q=bitcoin&geo=US&date=today%2012-m",
    formats: [{ type: "json", parser: "google-trends" }],
  }),
});
console.log(await response.json());
```

```python Python theme={null}
import os

import requests

response = requests.post(
    "https://api.stophy.dev/v1/scrape",
    headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
    json={
        "url": "https://trends.google.com/trends/explore?q=bitcoin&geo=US&date=today%2012-m",
        "formats": [{"type": "json", "parser": "google-trends"}],
    },
)
print(response.json())
```

## Read the response

The parser's data is in `data.json`. Its fields include `query` and `value`. This sample is cut to the first items.

```json theme={null}
{
  "success": true,
  "data": {
    "json": {
      "results": [
        {
          "query": "bitcoin price",
          "value": 100
        }
      ],
      "rising": [
        {
          "query": "spcx",
          "increasePercent": null,
          "isBreakout": true
        }
      ]
    }
  }
}
```

## Options

Send options in the `options` object of the `json` format.

| Option | What it does |
| - | - |
| `view` | Picks one of the answers this parser can give: `related`, `interest` and `regions`. |
| `searchType` | Google Trends' own search type: web, images, news, shopping or youtube. |
| `category` | Google Trends' own top-level category. |

## Price

\$1 per 1,000 calls. See [Pricing](https://docs.stophy.dev/account/pricing.md).

## Limits and errors

* The URL must be a Google Trends explore page with search terms in q, or the trending now page. One term gives its related searches and several terms give their interest over time. Set options.view to related, interest or regions to pick that answer for the terms. Any other URL fails with `invalidRequest`.
* The answer comes back in `data.json`. If the page cannot be read, the call fails with an error code from [Errors](https://docs.stophy.dev/api-reference/errors.md).

## Related

* [Pre-built parsers](https://docs.stophy.dev/scrape/prebuilt-parsers) lists every parser.
* [Scrape](https://docs.stophy.dev/scrape/overview) has the options every scrape takes.
* [Google Patents](https://docs.stophy.dev/scrape/prebuilt-parsers/web/google-patents.md)
* [Google Maps](https://docs.stophy.dev/scrape/prebuilt-parsers/places-and-travel/google-maps.md)
* [Google Maps place](https://docs.stophy.dev/scrape/prebuilt-parsers/places-and-travel/google-maps-place.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.