# Google Trends API — $0.0005 per trend

> Google Trends API: Today

[Home](https://quanticdata.io/)/[Collectors](https://quanticdata.io/collectors/)/*Google Trends API*

# Google Trends API

A Google Trends API that returns today's trending searches for a country as rows, not a page. Send a country code and get back each rising query with Google's traffic band, when it surfaced, a representative image and the news stories Google attached to it — billed per trend delivered.

[Get my free API key](https://app.quanticdata.io/register) [See the request](/collectors/google-trends-api/#integration)

$0.0005 per delivered trend · $2 free every month · Failed runs never billed

POST /v1/scraper/collectors/google_trends/run

```
$ curl $QD/google_trends/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"country": "us", "max_results": 10}'
{ "status": "done", "count": 10,
  "results": [
    {
      "query": "…",
      "approx_traffic": "…",
      "published": "…",
      "image": "…" } ],
  "cost": 0.005 }
# 10 trends × $0.0005 · nothing delivered, nothing charged
```

**$0.0005 / trend**4,000 trends on the free $2 every month

**Semantic input**country, max_results — no URL lists

**Up to 20**trends per run, pagination handled for you

**No browser**read over HTTP/TLS — cheaper and faster than rendering

On this page: [What it is](/collectors/google-trends-api/#what) [Output fields](/collectors/google-trends-api/#output) [Inputs](/collectors/google-trends-api/#input) [Pricing](/collectors/google-trends-api/#pricing) [Integration](/collectors/google-trends-api/#integration) [Use cases](/collectors/google-trends-api/#use-cases) [Versus the alternatives](/collectors/google-trends-api/#compare) [FAQ](/collectors/google-trends-api/#faq)

## What a Google Trends API does

This reads the trending-searches feed — the surface that lists what a country is searching right now, ranked, each with an approximate traffic band (Google never publishes an exact number) and the articles that explain why the query is climbing. It is the daily-trending view, not the interest-over-time curve for a keyword you already have in mind.

Google's own Trends API is in limited, access-gated alpha and centres on scaled interest over time; this collector needs no waitlist and answers from a plain request with no browser in the path. The feed is region-locked and lightly defended, so what it saves you is the exit rotation and the parsing — you send a country, you get rows.

Input is meaning, not a URL *country* *max_results*

## What one trend looks like

Every delivered trend carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

| Field | Type | What it holds |
| --- | --- | --- |
| `rank` | integer | Position in today's feed. |
| `query` | string | The trending search query. |
| `approx_traffic` | string · nullable | Google's traffic band, e.g. "1000+". |
| `published` | string · nullable | When Google surfaced the trend. |
| `image` | string · nullable | Representative image URL. |
| `articles` | object[] | News stories attached to the trend ({ title, url, source }). |
| `country` | string | Country the feed was read for. |

## Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

| Input | Type | Required | What it does |
| --- | --- | --- | --- |
| `country` | string | no | ISO 3166-1 alpha-2 code — which country's trending feed to read (default us). |
| `max_results` | integer | no | How many trends to deliver at most (1–20). You pay only for delivered trends. |

Pricing

## Google Trends API pricing

$0.0005 per delivered trend. A run that delivers nothing costs nothing: blocked pages, challenges and retries are on us, and the $2 monthly allowance covers about 4,000 trends before you spend anything.

**$0.0005**per delivered trend*$0.4 per 1,000 delivered trends*

**4,000 trends**on the free allowance*$2 every month, no card*

**Zero rows**zero charge*blocks, captchas and retries are on us*

**−30%**on volume tiers*the catalog returns your key's price*

### Pay as you go

$0/mo

- $2 free credit / month

- 60 requests / min

- List unit prices

### Starter

$19/mo

- $15 free credit / month

- 300 requests / min

- 10% off unit prices

Most popular

### Growth

$79/mo

- $50 free credit / month

- 600 requests / min

- 20% off unit prices

### Scale

$299/mo

- $250 free credit / month

- 1,200 requests / min

- 30% off unit prices

Same wallet, same key and same $2 monthly allowance as every other [Data API](https://quanticdata.io/web-data-api-for-ai/). Prices are launch pricing read live from the billing config — `GET /v1/scraper/collectors` returns the price your key actually pays.

Integration

## One POST, typed rows

Base URL `https://api.quanticdata.io/v1`, Bearer auth, the same key as every other Data API. Endpoint: `POST /v1/scraper/collectors/google_trends/run`.

```
curl -X POST https://api.quanticdata.io/v1/scraper/collectors/google_trends/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"us","max_results":10}'
```

```
import requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/google_trends/run",
    headers={"Authorization": f"Bearer {QD_API_KEY}"},
    json={
        "country": "us",
        "max_results": 10
    },
    timeout=120,
)
for row in r.json()["payload"]["results"]:
    print(row)
```

```
const res = await fetch(
  "https://api.quanticdata.io/v1/scraper/collectors/google_trends/run",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"country":"us","max_results":10}),
  },
);
const { payload } = await res.json();
console.table(payload.results);
```

```
claude mcp add quantumproxies \
  -e QUANTUMPROXIES_API_KEY=qd_live_your_key_here \
  -- npx -y quantumproxies-mcp

# then, in the chat:
> run the google_trends collector with country="us" and max_results=10
```

## What people build with the Google Trends API

Three shapes of work this endpoint was designed around.

### Newsroom monitoring

Poll a country's feed on a schedule and flag when a query enters the top ranks, with the attached articles already there to source the story.

### Trend-jacking content

Pull the rising queries for your market each morning and brief copy against the ones that sit next to your product.

### Demand signals

Store the daily feed per country to build your own history of what broke out and when, using the traffic band as a rough magnitude.

## Google Trends API versus rolling your own

The differences that actually cost time when you build this in-house.

|  | DIY scraper | This collector |
| --- | --- | --- |
| Access | Official Trends API in gated alpha, waitlisted | A country code, answered now |
| Shape | A page, or a library that breaks on the next markup change | Parsed rows: query, traffic band, published, articles |
| Attached news | Gathered in a second pass | The stories Google linked, on every trend |

## FAQ

Questions we get about the Google Trends API.

[Something else? Ask us →](mailto:hello@quanticdata.io)

### Is this the official Google Trends API?

No. Google's official Trends API is in limited alpha and access-gated; this is an independent collector that reads the public trending-searches feed for a country and returns it as rows, with no waitlist to join.

### Do I get interest over time for a keyword?

No — this is the trending surface, not the interest-over-time curve. It answers what a country is searching right now, ranked, with a traffic band and attached news, rather than a twelve-month line for a keyword you name.

### Which countries can I read?

Any country Google publishes a trending feed for: pass the ISO country code and the feed comes back for that region. One call reads one country's feed.

### How precise is the traffic figure?

Google publishes a band, not a number ("1000+"), so the collector returns exactly that band and never invents a precise count. Treat it as a rough magnitude, not a measured volume.

### Is there a free Google Trends API?

Every account gets $2 of credit every month with no card, which is about 4,000 delivered trends on this endpoint at $0.0005 each. It renews monthly, and a run that delivers nothing is never billed — so a failed or blocked attempt does not eat the allowance.

### How much does one run cost?

Multiply the rows you actually receive by $0.0005. A run capped at 20 trends — the maximum for this collector — costs $0.01 if every row comes back, and less when the source has fewer. Volume tiers take up to 30% off, and `GET /v1/scraper/collectors` returns the price your key actually pays.

## Run the Google Trends API now

$2 of free credit every month, no card. Your key returns its own prices from `GET /v1/scraper/collectors`.

[Get my free API key](https://app.quanticdata.io/register)

Related: [All 65 collectors](https://quanticdata.io/collectors/) [Google News API](https://quanticdata.io/collectors/google-news-api/) [Keyword research API](https://quanticdata.io/collectors/keyword-research-api/) [Google search results API](https://quanticdata.io/collectors/google-search-results-api/) [Google Autocomplete API](https://quanticdata.io/collectors/google-autocomplete-api/) [Google Events API](https://quanticdata.io/collectors/google-events-api/) [Documentation](https://quanticdata.io/docs/)

---

Source: https://quanticdata.io/collectors/google-trends-api/ · Site index for AI: https://quanticdata.io/llms.txt