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

# Google Trends API

> Google Trends search interest for a keyword, with interest over time and interest by region for the geography and time range you choose.

`POST /v1/data/google-trends/trends/run`

**Pricing:** $0.0045 per trend ($4.50 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**queries** `string[]` *required*

One or more search keywords. One request reads them all.

**country** `string`

Country to use.

241 allowed values, for example `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua and Barbuda), `AR` (Argentina). Fetch the full list with `GET /v1/data/google-trends/trends?expand=options`.

**timeRange** `string` (default: today 12-m)

Time Range to use. Past 12 months by default.

Allowed values: `now 1-H` (Past hour), `now 4-H` (Past 4 hours), `now 1-d` (Past day), `now 7-d` (Past 7 days), `today 1-m` (Past 30 days), `today 3-m` (Past 90 days), `today 12-m` (Past 12 months), `today 5-y` (Past 5 years), `all` (2004 - present).

**startDateEndDate** `string`

Start Date End Date.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/google-trends/trends/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "queries": [
      "super bowl"
    ],
    "country": "US",
    "timeRange": "today 12-m"
  }
}'
```

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

r = requests.post(
    "https://api.mindcase.co/v1/data/google-trends/trends/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "queries": [
        "super bowl"
    ],
    "country": "US",
    "timeRange": "today 12-m"
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/google-trends/trends/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "queries": [
    "super bowl"
  ],
  "country": "US",
  "timeRange": "today 12-m"
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one trend, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `queryId` | Query ID | text |
| `keyword` | Keyword | text |
| `geo` | Geo | text |
| `timeRange` | Time Range | text |
| `trendsUrl` | Trends URL | url |
| `interestOverTime` | Interest Over Time | object\_array |
| `interestByRegion` | Interest By Region | object\_array |
| `relatedQueries` | Related Queries | object |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "google-trends/trends",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "keyword": "super bowl",
      "queryId": "super bowl|US|today 12-m|",
      "geo": "US",
      "interestByRegion": [
        {
          "geoCode": "US-WY",
          "geoName": "Wyoming",
          "value": 100,
          "formattedValue": "100",
          "hasData": true,
          "isLeading": true
        },
        {
          "geoCode": "US-WA",
          "geoName": "Washington",
          "value": 97,
          "formattedValue": "97",
          "hasData": true,
          "isLeading": true
        }
      ],
      "relatedQueries": {
        "top": [
          {
            "value": 100,
            "formattedValue": "100",
            "hasData": true,
            "breakout": false,
            "link": "https://trends.google.com/trends/explore?q=super+bowl+2026&date=today+12-m&geo=US",
            "query": "super bowl 2026"
          },
          {
            "value": 33,
            "formattedValue": "33",
            "hasData": true,
            "breakout": false,
            "link": "https://trends.google.com/trends/explore?q=super+bowl+time&date=today+12-m&geo=US",
            "query": "super bowl time"
          },
          {
            "value": 22,
            "formattedValue": "22",
            "hasData": true,
            "breakout": false,
            "link": "https://trends.google.com/trends/explore?q=super+bowl+halftime&date=today+12-m&geo=US",
            "query": "super bowl halftime"
          }
        ],
        "rising": [
          {
            "value": 15300,
            "formattedValue": "Breakout",
            "hasData": true,
            "breakout": true,
            "link": "https://trends.google.com/trends/explore?q=budweiser+super+bowl+commercial+2026&date=today+12-m&geo=US",
            "query": "budweiser super bowl commercial 2026"
          },
          {
            "value": 12700,
            "formattedValue": "Breakout",
            "hasData": true,
            "breakout": true,
            "link": "https://trends.google.com/trends/explore?q=super+bowl+2026+where+to+watch&date=today+12-m&geo=US",
            "query": "super bowl 2026 where to watch"
          },
          {
            "value": 10250,
            "formattedValue": "Breakout",
            "hasData": true,
            "breakout": true,
            "link": "https://trends.google.com/trends/explore?q=watch+super+bowl+2026&date=today+12-m&geo=US",
            "query": "watch super bowl 2026"
          }
        ]
      },
      "interestOverTime": [
        {
          "date": "Oct 26, 2025",
          "dateRange": "Oct 26 – Nov 1, 2025",
          "timestamp": 1761436800,
          "value": 2,
          "formattedValue": "2",
          "hasData": true,
          "isPartial": false
        },
        {
          "date": "Nov 2, 2025",
          "dateRange": "Nov 2 – 8, 2025",
          "timestamp": 1762041600,
          "value": 2,
          "formattedValue": "2",
          "hasData": true,
          "isPartial": false
        }
      ],
      "timeRange": "today 12-m",
      "trendsUrl": "https://trends.google.com/trends/explore?q=super%20bowl&date=today%2012-m&geo=US"
    }
  ]
}
```

## Related APIs

For live search results use [`google/search`](https://docs.mindcase.co/apis/google/search).


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