Skip to main content
POST /v1/data/google-trends/trends/run Pricing: $0.0045 per trend ($4.50 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
required
One or more search keywords. One request reads them all.
string
Country to use.241 allowed values, for example AF (Afghanistan), AL (Albania), DZ (Algeria), AS (American Samoa), AD (Andorra), AO (Angola), AI (Anguilla), AQ (Antarctica), AG (Antigua and Barbuda), AR (Argentina). Fetch the full list with GET /v1/data/google-trends/trends?expand=options.
string
default:"today 12-m"
Time Range to use. Past 12 months by default.Allowed values: now 1-H (Past hour), now 4-H (Past 4 hours), now 1-d (Past day), now 7-d (Past 7 days), today 1-m (Past 30 days), today 3-m (Past 90 days), today 12-m (Past 12 months), today 5-y (Past 5 years), all (2004 - present).
string
Start Date End Date.

Example

Response fields

Each row in data is one trend, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For live search results use google/search.