> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/google-trends/report>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/google-trends/report.mdx>

---

# 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` 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.

## Request

- **Endpoint:** `GET /v1/google-trends/report`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by term and time range
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/google-trends/report/get)
- **Platform page:** [/platforms/google-trends](https://www.socialfetch.dev/platforms/google-trends)

## 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.