# Google Trends API

Put search interest on a timeline.

Ask your agent for a keyword’s search interest by country and time window. It gets back a dated series. Each request costs $0.05 through TaskFuel.

Relative search interest, not monthly search volume. The returned interval contained 32 daily points.

Provider in the worked example: Google Trends.

Price shown for this route: 5¢ per request.



## What it can do

### Read keyword interest over time

Request one keyword with a country and time window. The response identifies the dates, granularity and data source it actually served.

Price: $0.05 per request.


## A real example

Tested on 2026-11-17 through Google Trends.

The provider returned 32 daily points for US searches for bitcoin. The requested 30-day window produced dates from 17 October through 17 November.

Your agent asked: Get Google Trends interest for bitcoin in the US with the past_30_days window. Return the dates and interest values.

Returned in this test:

- Keyword: bitcoin
- Country: US
- Returned dates: 17 Oct–17 Nov 2026 · 32 daily points
- Interest: 44 at the first point; 77 at the last · scale 0–100

Charged in this test: $0.05.

Relative search interest, not monthly search volume. The returned interval contained 32 daily points.




## Try the API request

Use your TaskFuel API key as TASKFUEL_API_KEY in your terminal or server. Keep it out of browser code.

### 1. Check the price

This request checks the price without paying. This is the exact request used in the dated series example.

```sh
curl --fail-with-body https://app.taskfuel.ai/v1/call \
  -H "Authorization: Bearer $TASKFUEL_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'TASKFUEL_REQUEST'
{
  "url": "https://google-trends.use.x402atlas.com/trend-over-time?keyword=bitcoin&geo=US&timeframe=past_30_days",
  "method": "GET",
  "dryRun": true
}
TASKFUEL_REQUEST
```

### 2. Run the request

Review amount_usd in the quote. To pay and run, change dryRun to false and add maxAmountUsd with that approved amount inside the same JSON object. Keep the inputs unchanged; this limit applies to one call.

### 3. Read the result

Read series[].date and series[].value with geo, timeframe, granularity and data_source. The test returned data_source=primary. A fallback response can instead serve worldwide monthly data for the full historical range and includes a notice. The returned dates define the actual interval.

[Google’s official Trends API alpha](https://developers.google.com/search/apis/trends)

[Setup and API reference](https://taskfuel.ai/docs/) · [Job polling and timeout recovery](https://app.taskfuel.ai/using.md)


## Connect your agent

Read the [setup guide](https://taskfuel.ai/docs/setup/) and choose the connection your agent supports.

Use one TaskFuel account and prepaid balance. Inspect the provider and request quote before a paid call, then review the returned response and recorded charge.



## When to use it

### Add interest history to a brief.

Your agent can describe how the returned interest values changed over the dated series.

### Keep the dates with the values.

The daily points can populate a chart with the provider’s country, actual time range and relative-interest scale.




## Questions

### Is there an official Google Trends API?

Google offers a Trends API alpha with applications for early access. Google describes its data as consistently scaled over a rolling five years. The TaskFuel request uses a third-party provider, and its values are relative scores on a 0–100 scale.

### Are these values monthly search volumes?

No. Values are relative search-interest scores on a 0–100 scale. Monthly keyword volumes are a separate data type.

### Does the requested window always match the returned dates?

Our past_30_days request returned 32 daily points from 17 October to 17 November 2026. The provider also documents a fallback that can return worldwide monthly history instead of the requested country and window.

### What did the example cost?

The request cost $0.05 on 17 November 2026. Your agent shows the price for your own request before it pays.

### Do I need a provider account, an API key or a server?

No. Your agent pays from your TaskFuel balance. There is no provider account or API key to handle and no server to run. The unofficial pytrends library runs in your own code, and its repository was archived in April 2025.

## Related tool guides

- [Look up monthly keyword search volume](https://taskfuel.ai/tools/keyword-research-api/)
- [Compare SEO MCP options](https://taskfuel.ai/tools/seo-mcp/)
- [Search recent news with source links](https://taskfuel.ai/tools/google-news-api/)


## Reference

- [Read this guide on the website](https://taskfuel.ai/tools/google-trends-api/).
- [Browse providers and capabilities](https://taskfuel.ai/catalog/).
- [Pricing](https://taskfuel.ai/pricing/).
- [Agent instructions](https://taskfuel.ai/llms.txt).
