---
title: "Get Interest Over Time"
method: GET
path: "/google-trends/interest"
tags: ["Google Trends"]
---

# Get Interest Over Time

`GET /google-trends/interest`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/google-trends/interest`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `q` string, required
- `geo` string, nullable
- `time_range` '1h' | '4h' | '1d' | '7d' | '30d' | '90d' | '1y' | '5y' | 'all' | 'null', nullable
- `hl` string, nullable
- `search_type` 'web' | 'images' | 'news' | 'youtube' | 'shopping' | 'null', nullable

## Response `200`

Interest over time data retrieved successfully

- object
  - `search_parameters` object, required
    - `keyword` string, required
    - `keywords` string[]
    - `geo` string, required
    - `time_range` string, required
    - `hl` string, required
    - `search_type` string, required
  - `timeline_data` object[], required
    - `timestamp` integer, required
    - `date` string, required
    - `value` integer, required
    - `values` object[]
      - `query` string, required
      - `query_index` integer, required
      - `value` integer, required
      - `has_data` boolean, required
  - `interest_over_time` object, required
    - `average` number, required
    - `max_value` integer, required
    - `min_value` integer, required
    - `averages` object[]
      - `query` string, required
      - `query_index` integer, required
      - `value` number, required
    - `data_points` object[], required
      - `timestamp` integer, required
      - `date` string, required
      - `value` integer, required
  - `response_time_ms` integer, required

## Other responses

- `400`: Error response
- `401`: Unauthorized - API key is missing or invalid
- `422`: Error response
- `500`: Error response
- `503`: Error response

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)