SerpApi Google Trends API

https://serpapi.com/google-trends-api
Admin
SerpApi Google Trends API allows developers to scrape and retrieve search trend data from Google...
Tokens:1,194
Snippets:9
Trust Score:10
Update:2 months ago
Show doc for...
Tokens:
Raw
### Perform a Google Trends search request

Source: https://serpapi.com/google-trends-api

Use this GET request structure to query the Google Trends engine via SerpApi.

```http
GET https://serpapi.com/search?api_key=YOUR_API_KEY&engine=google_trends&q=QUERY
```

--------------------------------

### GET /search

Source: https://serpapi.com/google-trends-api

Retrieve Google Trends data by specifying the search query and optional parameters for location, language, and data type.

```APIDOC
## GET https://serpapi.com/search

### Description
Retrieve Google Trends data based on the provided search query and configuration parameters.

### Method
GET

### Endpoint
https://serpapi.com/search

### Parameters
#### Query Parameters
- **api_key** (string) - Required - Your SerpApi API key.
- **engine** (string) - Required - Must be set to "google_trends".
- **q** (string) - Required - The search term or topic. Multiple queries can be separated by commas (max 5 for specific data types).
- **hl** (string) - Optional - Two-letter language code for the search.
- **geo** (string) - Optional - Location from where the search originates. Defaults to Worldwide.
- **region** (string) - Optional - Specific region granularity (COUNTRY, REGION, DMA, CITY) for regional data types.
- **data_type** (string) - Optional - The type of search: TIMESERIES, GEO_MAP, GEO_MAP_0, RELATED_TOPICS, or RELATED_QUERIES.
```

--------------------------------

### Google Trends API Parameters

Source: https://serpapi.com/google-trends-api

A comprehensive list of parameters available for the Google Trends API, including both search-specific configurations and SerpApi integration settings.

```APIDOC
## Google Trends API Parameters

### Advanced Parameters

- **tz** (integer) - Optional - Time zone offset in minutes. Default is 420 (PDT).
- **cat** (integer) - Optional - Search category ID. Default is 0 (All categories).
- **gprop** (string) - Optional - Property to sort results by (images, news, froogle, youtube). Default is Web Search.
- **date** (string) - Optional - Date range for the search (e.g., 'now 7-d', 'today 12-m', or custom 'yyyy-mm-dd yyyy-mm-dd').
- **csv** (boolean) - Optional - Set to true to retrieve CSV results as an array.
- **include_low_search_volume** (boolean) - Optional - Set to true to include low search volume regions. Only applicable if data_type is GEO_MAP or GEO_MAP_0.

### SerpApi Parameters

- **engine** (string) - Required - Set to 'google_trends' to use the Google Trends API.
- **api_key** (string) - Required - Your SerpApi private key.
- **no_cache** (boolean) - Optional - Force fetch results even if cached. Default is false.
- **async** (boolean) - Optional - Submit search asynchronously. Default is false.
- **zero_trace** (boolean) - Optional - Enterprise only. Enable ZeroTrace mode to skip storing search data.
- **output** (string) - Optional - Final output format (json or html). Default is json.
- **json_restrictor** (string) - Optional - Fields to include in the output to reduce payload size.
```

--------------------------------

### Google Trends API JSON Response

Source: https://serpapi.com/google-trends-api

Sample JSON structure showing the interest_over_time timeline data format.

```json
{
  "interest_over_time": {
    "timeline_data": [
      {
        "date": "Dec 29, 2024 – Jan 4, 2025",
        "timestamp": "1735430400",
        "values": [
          {
            "query": "quantum computing",
            "value": "8",
            "extracted_value": 8
          }
        ]
      }
    ]
  }
}
```
Tokens:
Raw