# Google Trends

DataForSEO

Compare relative keyword interest over time or by region, and find related queries and topics.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Google Trends (tool ID: dataforseo.google-trends). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Check keyword search volume](https://scrollport.com/tools/keyword-search-volume-api)

**Current price:** $0.0154/request

**Availability:** Ready to run

## Tool details

**About this tool**

Get one Google Trends report per request: timeline, regional interest, related queries or related topics. Compare up to five keywords for one flat request price; related reports require exactly one keyword. Choose Google web, News, Images, Shopping or YouTube and a recent time window. Omit location_name for worldwide results. Interest scores are relative (0–100), not absolute search volumes. Zero/null may mean insufficient data, and missing_data marks incomplete periods. A completed sparse report is charged at the ordinary request price; failed requests are uncharged. The response explicitly identifies reports with no usable data. Shared Google Trends capacity can cause upstream limits; typical requests may take tens of seconds. For related topics, prefer web, News or YouTube. Google can omit related topics for Image Search and Shopping even for common keywords; choose related_queries for those searches instead.

**Inputs and outputs**

### Input

`category_code` integer · optional

Google Trends category code; omit for all categories.

minimum: 0

`keywords` array · required

Distinct keywords without commas. Related-query/topic reports require exactly one.

minItems: 1 · maxItems: 5

`language_name` string · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

`location_name` string · optional

Full region name such as United Kingdom or United States. Omit for worldwide.

minLength: 1 · maxLength: 200

`report_type` string · optional

Value supplied for report type.

enum: timeline, regions, related_queries, related_topics

`search_type` string · optional

Value supplied for search type.

enum: web, news, images, shopping, youtube

`time_range` string · optional

Value supplied for time range.

enum: past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

### Output

`category_code` number

Returned category code value.

`data_available` boolean

Returned data available value.

`interpretation` string

Returned interpretation value.

`items` array

Returned items value.

`items_count` number

Returned items count value.

`keywords` array

Returned keywords value.

`language_name` string

Returned language name value.

`location_name` string

Returned location name value.

`report_type` string

Returned report type value.

`search_type` string

Returned search type value.

`source` string

Returned source value.

`time_range` string

Returned time range value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "dataforseo.google-trends",
  "input": {
    "keywords": [
      "coffee",
      "tea"
    ],
    "time_range": "past_7_days",
    "report_type": "timeline",
    "search_type": "web",
    "location_name": "United Kingdom"
  }
}
```

### Output

```
{
  "items": [
    {
      "data": [
        {
          "values": [
            67,
            33
          ],
          "timestamp": 1788782400,
          "missing_data": false
        },
        {
          "values": [
            63,
            33
          ],
          "timestamp": 1788786000,
          "missing_data": false
        },
        {
          "values": [
            60,
            34
          ],
          "timestamp": 1788789600,
          "missing_data": false
        },
        {
          "values": [
            56,
            34
          ],
          "timestamp": 1788793200,
          "missing_data": false
        },
        {
          "values": [
            54,
            36
          ],
          "timestamp": 1788796800,
          "missing_data": false
        },
        {
          "values": [
            53,
            34
          ],
          "timestamp": 1788800400,
          "missing_data": false
        },
        {
          "values": [
            52,
            35
          ],
          "timestamp": 1788804000,
          "missing_data": false
        },
        {
          "values": [
            55,
            40
          ],
          "timestamp": 1788807600,
          "missing_data": false
        },
        {
          "values": [
            53,
            42
          ],
          "timestamp": 1788811200,
          "missing_data": false
        },
        {
          "values": [
            53,
            40
          ],
          "timestamp": 1788814800,
          "missing_data": false
        },
        {
          "values": [
            58,
            38
          ],
          "timestamp": 1788818400,
          "missing_data": false
        },
        {
          "values": [
            57,
            35
          ],
          "timestamp": 1788822000,
          "missing_data": false
        },
        {
          "values": [
            62,
            33
          ],
          "timestamp": 1788825600,
          "missing_data": false
        },
        {
          "values": [
            65,
            34
          ],
          "timestamp": 1788829200,
          "missing_data": false
        },
        {
          "values": [
            61,
            36
          ],
          "timestamp": 1788832800,
          "missing_data": false
        },
        {
          "values": [
            73,
            29
          ],
          "timestamp": 1788836400,
          "missing_data": false
        },
        {
          "values": [
            76,
            35
          ],
          "timestamp": 1788840000,
          "missing_data": false
        },
        {
          "values": [
            73,
            32
          ],
          "timestamp": 1788843600,
          "missing_data": false
        },
        {
          "values": [
            72,
            33
          ],
          "timestamp": 1788847200,
          "missing_data": false
        },
        {
          "values": [
            77,
            35
          ],
          "timestamp": 1788850800,
          "missing_data": false
        },
        {
          "values": [
            75,
            33
          ],
          "timestamp": 1788854400,
          "missing_data": false
        },
        {
          "values": [
            71,
            34
          ],
          "timestamp": 1788858000,
          "missing_data": false
        },
        {
          "values": [
            74,
            35
          ],
          "timestamp": 1788861600,
          "missing_data": false
        },
        {
          "values": [
            70,
            34
          ],
          "timestamp": 1788865200,
          "missing_data": false
        },
        {
          "values": [
            65,
            34
          ],
          "timestamp": 1788868800,
          "missing_data": false
        },
        {
          "values": [
            58,
            35
          ],
          "timestamp": 1788872400,
          "missing_data": false
        },
        {
          "values": [
            58,
            35
          ],
          "timestamp": 1788876000,
          "missing_data": false
        },
        {
          "values": [
            52,
            33
          ],
          "timestamp": 1788879600,
          "missing_data": false
        },
        {
          "values": [
            50,
            33
          ],
          "timestamp": 1788883200,
          "missing_data": false
        },
        {
          "values": [
            47,
            34
          ],
          "timestamp": 1788886800,
          "missing_data": false
        },
        {
          "values": [
            46,
            34
          ],
          "timestamp": 1788890400,
          "missing_data": false
        },
        {
          "values": [
            49,
            36
          ],
          "timestamp": 1788894000,
          "missing_data": false
        },
        {
          "values": [
            48,
            36
          ],
          "timestamp": 1788897600,
          "missing_data": false
        },
        {
          "values": [
            48,
            34
          ],
          "timestamp": 1788901200,
          "missing_data": false
        },
        {
          "values": [
            55,
            34
          ],
          "timestamp": 1788904800,
          "missing_data": false
        },
        {
          "values": [
            49,
            36
          ],
          "timestamp": 1788908400,
          "missing_data": false
        },
        {
          "values": [
            52,
            30
          ],
          "timestamp": 1788912000,
          "missing_data": false
        },
        {
          "values": [
            61,
            31
          ],
          "timestamp": 1788915600,
          "missing_data": false
        },
        {
          "values": [
            68,
            33
          ],
          "timestamp": 1788919200,
          "missing_data": false
        },
        {
          "values": [
            74,
            36
          ],
          "timestamp": 1788922800,
          "missing_data": false
        },
        {
          "values": [
            71,
            36
          ],
          "timestamp": 1788926400,
          "missing_data": false
        },
        {
          "values": [
            70,
            34
          ],
          "timestamp": 1788930000,
          "missing_data": false
        },
        {
          "values": [
            68,
            33
          ],
          "timestamp": 1788933600,
          "missing_data": false
        },
        {
          "values": [
            73,
            35
          ],
          "timestamp": 1788937200,
          "missing_data": false
        },
        {
          "values": [
            71,
            35
          ],
          "timestamp": 1788940800,
          "missing_data": false
        },
        {
          "values": [
            72,
            33
          ],
          "timestamp": 1788944400,
          "missing_data": false
        },
        {
          "values": [
            65,
            34
          ],
          "timestamp": 1788948000,
          "missing_data": false
        },
        {
          "values": [
            62,
            36
          ],
          "timestamp": 1788951600,
          "missing_data": false
        },
        {
          "values": [
            61,
            35
          ],
          "timestamp": 1788955200,
          "missing_data": false
        },
        {
          "values": [
            54,
            35
          ],
          "timestamp": 1788958800,
          "missing_data": false
        },
        {
          "values": [
            51,
            34
          ],
          "timestamp": 1788962400,
          "missing_data": false
        },
        {
          "values": [
            52,
            35
          ],
          "timestamp": 1788966000,
          "missing_data": false
        },
        {
          "values": [
            50,
            34
          ],
          "timestamp": 1788969600,
          "missing_data": false
        },
        {
          "values": [
            47,
            34
          ],
          "timestamp": 1788973200,
          "missing_data": false
        },
        {
          "values": [
            45,
            34
          ],
          "timestamp": 1788976800,
          "missing_data": false
        },
        {
          "values": [
            42,
            37
          ],
          "timestamp": 1788980400,
          "missing_data": false
        },
        {
          "values": [
            46,
            37
          ],
          "timestamp": 1788984000,
          "missing_data": false
        },
        {
          "values": [
            47,
            36
          ],
          "timestamp": 1788987600,
          "missing_data": false
        },
        {
          "values": [
            48,
            34
          ],
          "timestamp": 1788991200,
          "missing_data": false
        },
        {
          "values": [
            51,
            31
          ],
          "timestamp": 1788994800,
          "missing_data": false
        },
        {
          "values": [
            51,
            31
          ],
          "timestamp": 1788998400,
          "missing_data": false
        },
        {
          "values": [
            52,
            29
          ],
          "timestamp": 1789002000,
          "missing_data": false
        },
        {
          "values": [
            57,
            32
          ],
          "timestamp": 1789005600,
          "missing_data": false
        },
        {
          "values": [
            60,
            33
          ],
          "timestamp": 1789009200,
          "missing_data": false
        },
        {
          "values": [
            66,
            32
          ],
          "timestamp": 1789012800,
          "missing_data": false
        },
        {
          "values": [
            76,
            35
          ],
          "timestamp": 1789016400,
          "missing_data": false
        },
        {
          "values": [
            73,
            33
          ],
          "timestamp": 1789020000,
          "missing_data": false
        },
        {
          "values": [
            72,
            35
          ],
          "timestamp": 1789023600,
          "missing_data": false
        },
        {
          "values": [
            71,
            34
          ],
          "timestamp": 1789027200,
          "missing_data": false
        },
        {
          "values": [
            69,
            35
          ],
          "timestamp": 1789030800,
          "missing_data": false
        },
        {
          "values": [
            67,
            35
          ],
          "timestamp": 1789034400,
          "missing_data": false
        },
        {
          "values": [
            66,
            34
          ],
          "timestamp": 1789038000,
          "missing_data": false
        },
        {
          "values": [
            63,
            34
          ],
          "timestamp": 1789041600,
          "missing_data": false
        },
        {
          "values": [
            59,
            34
          ],
          "timestamp": 1789045200,
          "missing_data": false
        },
        {
          "values": [
            52,
            33
          ],
          "timestamp": 1789048800,
          "missing_data": false
        },
        {
          "values": [
            47,
            36
          ],
          "timestamp": 1789052400,
          "missing_data": false
        },
        {
          "values": [
            48,
            36
          ],
          "timestamp": 1789056000,
          "missing_data": false
        },
        {
          "values": [
            48,
            36
          ],
          "timestamp": 1789059600,
          "missing_data": false
        },
        {
          "values": [
            47,
            36
          ],
          "timestamp": 1789063200,
          "missing_data": false
        },
        {
          "values": [
            48,
            35
          ],
          "timestamp": 1789066800,
          "missing_data": false
        },
        {
          "values": [
            52,
            40
          ],
          "timestamp": 1789070400,
          "missing_data": false
        },
        {
          "values": [
            50,
            40
          ],
          "timestamp": 1789074000,
          "missing_data": false
        },
        {
          "values": [
            53,
            38
          ],
          "timestamp": 1789077600,
          "missing_data": false
        },
        {
          "values": [
            52,
            34
          ],
          "timestamp": 1789081200,
          "missing_data": false
        },
        {
          "values": [
            61,
            36
          ],
          "timestamp": 1789084800,
          "missing_data": false
        },
        {
          "values": [
            65,
            35
          ],
          "timestamp": 1789088400,
          "missing_data": false
        },
        {
          "values": [
            64,
            34
          ],
          "timestamp": 1789092000,
          "missing_data": false
        },
        {
          "values": [
            72,
            41
          ],
          "timestamp": 1789095600,
          "missing_data": false
        },
        {
          "values": [
            75,
            35
          ],
          "timestamp": 1789099200,
          "missing_data": false
        },
        {
          "values": [
            73,
            33
          ],
          "timestamp": 1789102800,
          "missing_data": false
        },
        {
          "values": [
            76,
            34
          ],
          "timestamp": 1789106400,
          "missing_data": false
        },
        {
          "values": [
            76,
            34
          ],
          "timestamp": 1789110000,
          "missing_data": false
        },
        {
          "values": [
            73,
            35
          ],
          "timestamp": 1789113600,
          "missing_data": false
        },
        {
          "values": [
            70,
            36
          ],
          "timestamp": 1789117200,
          "missing_data": false
        },
        {
          "values": [
            64,
            34
          ],
          "timestamp": 1789120800,
          "missing_data": false
        },
        {
          "values": [
            65,
            37
          ],
          "timestamp": 1789124400,
          "missing_data": false
        },
        {
          "values": [
            59,
            34
          ],
          "timestamp": 1789128000,
          "missing_data": false
        },
        {
          "values": [
            57,
            33
          ],
          "timestamp": 1789131600,
          "missing_data": false
        },
        {
          "values": [
            52,
            36
          ],
          "timestamp": 1789135200,
          "missing_data": false
        },
        {
          "values": [
            49,
            35
          ],
          "timestamp": 1789138800,
          "missing_data": false
        },
        {
          "values": [
            46,
            34
          ],
          "timestamp": 1789142400,
          "missing_data": false
        },
        {
          "values": [
            46,
            34
          ],
          "timestamp": 1789146000,
          "missing_data": false
        },
        {
          "values": [
            43,
            39
          ],
          "timestamp": 1789149600,
          "missing_data": false
        },
        {
          "values": [
            48,
            37
          ],
          "timestamp": 1789153200,
          "missing_data": false
        },
        {
          "values": [
            48,
            37
          ],
          "timestamp": 1789156800,
          "missing_data": false
        },
        {
          "values": [
            50,
            37
          ],
          "timestamp": 1789160400,
          "missing_data": false
        },
        {
          "values": [
            49,
            32
          ],
          "timestamp": 1789164000,
          "missing_data": false
        },
        {
          "values": [
            44,
            32
          ],
          "timestamp": 1789167600,
          "missing_data": false
        },
        {
          "values": [
            46,
            33
          ],
          "timestamp": 1789171200,
          "missing_data": false
        },
        {
          "values": [
            52,
            32
          ],
          "timestamp": 1789174800,
          "missing_data": false
        },
        {
          "values": [
            54,
            39
          ],
          "timestamp": 1789178400,
          "missing_data": false
        },
        {
          "values": [
            68,
            43
          ],
          "timestamp": 1789182000,
          "missing_data": false
        },
        {
          "values": [
            69,
            40
          ],
          "timestamp": 1789185600,
          "missing_data": false
        },
        {
          "values": [
            78,
            33
          ],
          "timestamp": 1789189200,
          "missing_data": false
        },
        {
          "values": [
            90,
            39
          ],
          "timestamp": 1789192800,
          "missing_data": false
        },
        {
          "values": [
            95,
            43
          ],
          "timestamp": 1789196400,
          "missing_data": false
        },
        {
          "values": [
            94,
            43
          ],
          "timestamp": 1789200000,
          "missing_data": false
        },
        {
          "values": [
            91,
            43
          ],
          "timestamp": 1789203600,
          "missing_data": false
        },
        {
          "values": [
            84,
            41
          ],
          "timestamp": 1789207200,
          "missing_data": false
        },
        {
          "values": [
            79,
            42
          ],
          "timestamp": 1789210800,
          "missing_data": false
        },
        {
          "values": [
            73,
            42
          ],
          "timestamp": 1789214400,
          "missing_data": false
        },
        {
          "values": [
            67,
            43
          ],
          "timestamp": 1789218000,
          "missing_data": false
        },
        {
          "values": [
            62,
            38
          ],
          "timestamp": 1789221600,
          "missing_data": false
        },
        {
          "values": [
            60,
            40
          ],
          "timestamp": 1789225200,
          "missing_data": false
        },
        {
          "values": [
            54,
            37
          ],
          "timestamp": 1789228800,
          "missing_data": false
        },
        {
          "values": [
            53,
            39
          ],
          "timestamp": 1789232400,
          "missing_data": false
        },
        {
          "values": [
            50,
            39
          ],
          "timestamp": 1789236000,
          "missing_data": false
        },
        {
          "values": [
            47,
            37
          ],
          "timestamp": 1789239600,
          "missing_data": false
        },
        {
          "values": [
            46,
            36
          ],
          "timestamp": 1789243200,
          "missing_data": false
        },
        {
          "values": [
            45,
            35
          ],
          "timestamp": 1789246800,
          "missing_data": false
        },
        {
          "values": [
            47,
            32
          ],
          "timestamp": 1789250400,
          "missing_data": false
        },
        {
          "values": [
            41,
            29
          ],
          "timestamp": 1789254000,
          "missing_data": false
        },
        {
          "values": [
            44,
            30
          ],
          "timestamp": 1789257600,
          "missing_data": false
        },
        {
          "values": [
            43,
            30
          ],
          "timestamp": 1789261200,
          "missing_data": false
        },
        {
          "values": [
            47,
            31
          ],
          "timestamp": 1789264800,
          "missing_data": false
        },
        {
          "values": [
            47,
            30
          ],
          "timestamp": 1789268400,
          "missing_data": false
        },
        {
          "values": [
            59,
            32
          ],
          "timestamp": 1789272000,
          "missing_data": false
        },
        {
          "values": [
            72,
            31
          ],
          "timestamp": 1789275600,
          "missing_data": false
        },
        {
          "values": [
            87,
            37
          ],
          "timestamp": 1789279200,
          "missing_data": false
        },
        {
          "values": [
            99,
            44
          ],
          "timestamp": 1789282800,
          "missing_data": false
        },
        {
          "values": [
            100,
            44
          ],
          "timestamp": 1789286400,
          "missing_data": false
        },
        {
          "values": [
            97,
            42
          ],
          "timestamp": 1789290000,
          "missing_data": false
        },
        {
          "values": [
            89,
            43
          ],
          "timestamp": 1789293600,
          "missing_data": false
        },
        {
          "values": [
            81,
            42
          ],
          "timestamp": 1789297200,
          "missing_data": false
        },
        {
          "values": [
            73,
            42
          ],
          "timestamp": 1789300800,
          "missing_data": false
        },
        {
          "values": [
            72,
            43
          ],
          "timestamp": 1789304400,
          "missing_data": false
        },
        {
          "values": [
            65,
            39
          ],
          "timestamp": 1789308000,
          "missing_data": false
        },
        {
          "values": [
            57,
            36
          ],
          "timestamp": 1789311600,
          "missing_data": false
        },
        {
          "values": [
            53,
            37
          ],
          "timestamp": 1789315200,
          "missing_data": false
        },
        {
          "values": [
            47,
            37
          ],
          "timestamp": 1789318800,
          "missing_data": false
        },
        {
          "values": [
            49,
            35
          ],
          "timestamp": 1789322400,
          "missing_data": false
        },
        {
          "values": [
            50,
            39
          ],
          "timestamp": 1789326000,
          "missing_data": false
        },
        {
          "values": [
            54,
            37
          ],
          "timestamp": 1789329600,
          "missing_data": false
        },
        {
          "values": [
            49,
            36
          ],
          "timestamp": 1789333200,
          "missing_data": false
        },
        {
          "values": [
            53,
            31
          ],
          "timestamp": 1789336800,
          "missing_data": false
        },
        {
          "values": [
            57,
            34
          ],
          "timestamp": 1789340400,
          "missing_data": false
        },
        {
          "values": [
            54,
            37
          ],
          "timestamp": 1789344000,
          "missing_data": false
        },
        {
          "values": [
            56,
            32
          ],
          "timestamp": 1789347600,
          "missing_data": false
        },
        {
          "values": [
            59,
            34
          ],
          "timestamp": 1789351200,
          "missing_data": false
        },
        {
          "values": [
            83,
            32
          ],
          "timestamp": 1789354800,
          "missing_data": false
        },
        {
          "values": [
            60,
            34
          ],
          "timestamp": 1789358400,
          "missing_data": false
        },
        {
          "values": [
            70,
            33
          ],
          "timestamp": 1789362000,
          "missing_data": false
        },
        {
          "values": [
            68,
            31
          ],
          "timestamp": 1789365600,
          "missing_data": false
        },
        {
          "values": [
            98,
            32
          ],
          "timestamp": 1789369200,
          "missing_data": false
        },
        {
          "values": [
            71,
            31
          ],
          "timestamp": 1789372800,
          "missing_data": false
        },
        {
          "values": [
            69,
            34
          ],
          "timestamp": 1789376400,
          "missing_data": false
        },
        {
          "values": [
            70,
            34
          ],
          "timestamp": 1789380000,
          "missing_data": false
        },
        {
          "values": [
            67,
            34
          ],
          "timestamp": 1789383600,
          "missing_data": false
        },
        {
          "values": [
            61,
            36
          ],
          "timestamp": 1789387200,
          "missing_data": true
        }
      ],
      "type": "google_trends_graph",
      "title": null,
      "averages": [
        61,
        35
      ],
      "keywords": [
        "coffee",
        "tea"
      ]
    }
  ],
  "source": "google_trends",
  "keywords": [
    "coffee",
    "tea"
  ],
  "time_range": "past_7_days",
  "items_count": 1,
  "report_type": "timeline",
  "search_type": "web",
  "category_code": 0,
  "language_name": "English",
  "location_name": "United Kingdom",
  "data_available": true,
  "interpretation": "Interest scores are relative (0–100), not search volumes. Timeline timestamp is the bucket start in Unix seconds (UTC). Zero or null can mean insufficient data; missing_data marks incomplete periods. Related rising values represent growth and may say Breakout."
}
```

**Errors and limitations**

- `invalid_input`: The keyword list or report options are invalid.Use 1–5 distinct keywords without commas; related reports require exactly one keyword.
- `rate_limited`: The supplier's shared Google Trends capacity is temporarily limited.The wallet was not charged. Wait before making a new request.
- `upstream_timeout`: The Google Trends report did not complete within the time limit.The wallet was not charged. Check the existing Scrollport run before starting another request.

---

Canonical page: https://scrollport.com/tools/providers/dataforseo/google-trends