Social Fetch
Start for freeStart free
Google Trends hub

Google Trends Report API

Time series, regions and related queries for one term in one request, instead of three separate calls.

GET /v1/google-trends/report

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/google-trends/report takes one query, plus geo, time, and optional category, source and language. It returns the three parts together: data.timeSeries with resolution, points, averages and notes; data.regions with resolution and regions[]; and data.relatedQueries with top[] and rising[].

The request is useful when a screen or an agent needs the whole picture for one term, because the three parts describe the same term, place and range. All values are relative inside this one request. When the time series has no data the answer is lookupStatus: "no_data" with an empty regions array; otherwise it is found. The route takes one term only.

Google Trends Report API FAQ

How is this different from three separate calls?

It returns timeSeries, regions and relatedQueries in one response with the same geo, time, category, source and language. That saves two requests and keeps the three parts consistent.

Can I compare several terms?

No. The report takes one term. Use interest over time or interest by region to compare one to five terms.

What does each part contain?

timeSeries has points with time, label, values, hasData, isPartial and period. regions has rows with geo, name, values, hasData, leadingTermIndex and coordinates. relatedQueries has the top and rising lists.

What does no_data mean for a report?

The time series has no data for the term. HTTP is 200 and lookupStatus is no_data; timeSeries.points is empty or every data flag is false, and regions is empty.

How much does a report cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Google Trends endpoints