Google trends interest over time API

Get Google Trends search interest over time, newest first, with one value per query

curl --request POST \
  --url https://api.stophy.dev/v1/google/trends/interest \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "queries": [
    "bitcoin",
    "ethereum"
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({queries: ['bitcoin', 'ethereum']})
};

fetch('https://api.stophy.dev/v1/google/trends/interest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/google/trends/interest"

payload = { "queries": ["bitcoin", "ethereum"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "recordedAt": "2023-11-07T05:31:56Z",
        "isPartial": true,
        "values": {}
      }
    ],
    "averages": {}
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

POST

google

trends

interest

Get Google Trends search interest over time, newest first, with one value per query

curl --request POST \
  --url https://api.stophy.dev/v1/google/trends/interest \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "queries": [
    "bitcoin",
    "ethereum"
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({queries: ['bitcoin', 'ethereum']})
};

fetch('https://api.stophy.dev/v1/google/trends/interest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/google/trends/interest"

payload = { "queries": ["bitcoin", "ethereum"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "recordedAt": "2023-11-07T05:31:56Z",
        "isPartial": true,
        "values": {}
      }
    ],
    "averages": {}
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

Returns Google Trends search interest over time, newest first, with one value per query.

Request

queries is required.

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.google.trends.interest({ queries: ["bitcoin", "ethereum"] });
console.log(result.data.results);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.google.trends.interest(queries=["bitcoin", "ethereum"])
print(result["data"]["results"])

curl -X POST https://api.stophy.dev/v1/google/trends/interest \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"queries":["bitcoin","ethereum"]}'

stophy google trends interest --queries bitcoin,ethereum

Response

If successful, the response body contains the standard envelope. data.results[] contains search interest over time, newest first, with one value for each query. The following example is a real response, truncated: each list shows one item and long strings are cut.

{
  "success": true,
  "data": {
    "results": [
      {
        "recordedAt": "2026-10-04T00:00:00.000Z",
        "values": {
          "bitcoin": 22,
          "ethereum": 3
        },
        "isPartial": true
      }
    ],
    "averages": {
      "bitcoin": 44,
      "ethereum": 7
    }
  },
  "creditsUsed": 1,
  "requestId": "2fe9dbad-fc48-4890-9751-0b24b596035b"
}

Field	Type	Description
`values`	object	Search interest for each query, relative to the peak value of 100.
`isPartial`	boolean	`true` if the period has not ended.
`averages`	object	The mean interest for each query over the full range.

For every field, see the response schema on this page.

Optional parameters

Parameter	Type	Description
`country`	string	The country to query, as a two-letter ISO 3166-1 code such as `us`.
`time`	string	Specifies the time range. Acceptable values are `pastHour`, `past4Hours`, `pastDay`, `past7Days`, `past30Days`, `past90Days`, `past12Months`, `past5Years` and `since2004`. If unset, defaults to `past12Months`.
`searchType`	string	Specifies the Google property the searches were made on. Acceptable values are `web`, `images`, `news`, `shopping` and `youtube`. If unset, defaults to `web`.
`category`	string	Restricts results to searches in this category. Accepts one of 25 values, such as `artsEntertainment`, `autosVehicles` and `beautyFitness`.

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

This method is not paginated. A single request returns the complete result.

Google Trends by region: Accepts the same queries. Returns Google Trends search interest by region.
Google Trends related searches: Accepts one of the same queries as query. Returns related searches for a keyword.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

queries

string[]

required

Required array length: 1 - 5 elements

Required string length: 1 - 100

country

string

ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.

Pattern: ^[A-Za-z]{2}$

time

enum<string>

default:past12Months

Google Trends' own time range.

Available options:

pastHour,

past4Hours,

pastDay,

past7Days,

past30Days,

past90Days,

past12Months,

past5Years,

since2004

searchType

enum<string>

default:web

Google Trends' own search type: web, images, news, shopping or youtube.

Available options:

web,

images,

news,

shopping,

youtube

Response

The data, and the credits this call used.

success

any

required

data

object

required

Show child attributes

creditsUsed

integer

required

requestId

string

required

Using the API

Catalog

Account

Search and AI answers

Video

Social

Places and travel

Jobs

Shopping

Apps

Real estate

Ads

Google trends interest over time API

Request

Response

Optional parameters

Billing

Authorizations

Body

Response

​Request

​Response

​Optional parameters

​Billing

​Pagination

​Related methods

Authorizations

Body

Response

Request

Response

Optional parameters

Billing

Pagination

Related methods