Google Trends — API reference

POST

Available

/google/trends

Google Trends

Google Trends interest over time, by region and related queries for up to five comma-separated terms.

type

google_trends

result

schemas.source_data

Billing

2 credits

Google Trends interest over time, by region and related queries for up to five comma-separated terms.

Parameters

FieldTypeAvailabilityDescription

q

sample

string

Catalog sample; the API validates required fields.

sample: "coffee"

cat

optional

string

optional

Public alias for category_id. Use one spelling at a time; the API validates the parameters and values supported by this product.

country

optional

string

optional

Public alias for locale.country. Use one spelling at a time; the API validates the parameters and values supported by this product.

cursor

optional

string

optional

Public alias for pagination.cursor. Use one spelling at a time; the API validates the parameters and values supported by this product.

date

optional

string

optional

Public alias for time_range. Use one spelling at a time; the API validates the parameters and values supported by this product.

device

optional

string

optional

Public alias for options.device. Use one spelling at a time; the API validates the parameters and values supported by this product.

geo

optional

string

optional

Public alias for attributes.geo. Use one spelling at a time; the API validates the parameters and values supported by this product.

gl

optional

string

optional

Public alias for locale.country. Use one spelling at a time; the API validates the parameters and values supported by this product.

google_domain

optional

string

optional

Public alias for locale.engine_domain. Use one spelling at a time; the API validates the parameters and values supported by this product.

gooogle_domain

optional

string

optional

Public alias for locale.engine_domain. Use one spelling at a time; the API validates the parameters and values supported by this product.

gprop

optional

string

optional

Public alias for attributes.gprop. Use one spelling at a time; the API validates the parameters and values supported by this product.

hl

optional

string

optional

Public alias for locale.language. Use one spelling at a time; the API validates the parameters and values supported by this product.

html

optional

boolean

optional

Public alias for include_html. Use one spelling at a time; the API validates the parameters and values supported by this product.

include_low_search_volume

optional

string

optional

Public alias for attributes.include_low_search_volume. Use one spelling at a time; the API validates the parameters and values supported by this product.

language

optional

string

optional

Public alias for locale.language. Use one spelling at a time; the API validates the parameters and values supported by this product.

limit

optional

integer

optional

Public alias for pagination.limit. Use one spelling at a time; the API validates the parameters and values supported by this product.

markdown

optional

boolean

optional

Public alias for include_markdown. Use one spelling at a time; the API validates the parameters and values supported by this product.

mobile

optional

boolean

optional

Public alias for options.device. Use one spelling at a time; the API validates the parameters and values supported by this product.

num

optional

integer

optional

Public alias for pagination.limit. Use one spelling at a time; the API validates the parameters and values supported by this product.

page

optional

integer

optional

Public alias for pagination.page. Use one spelling at a time; the API validates the parameters and values supported by this product.

region

optional

string

optional

Public alias for attributes.region. Use one spelling at a time; the API validates the parameters and values supported by this product.

results

optional

integer

optional

Public alias for pagination.limit. Use one spelling at a time; the API validates the parameters and values supported by this product.

tz

optional

string

optional

Public alias for attributes.tz. Use one spelling at a time; the API validates the parameters and values supported by this product.

json

{
  "q": "coffee"
}

Open in Playground

The response follows this product's contract; no recorded response example is published yet.schemas.source_data

Code and response examples

bash

curl -X POST 'https://api.serpbase.dev/google/trends' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"q":"coffee"}'

Notes

Use the catalog sample to get started, then inspect the actual JSON response.

The sample shows example parameters, not the complete request contract. Known fields are validated by the API; additional parameters are allowed.