# Google Trends API
> Live trending Google searches by country, with no key. This reads Google's own public Daily Search Trends RSS feed and returns it as clean JSON: what people are searching for right now in any country, each trend with its approximate search volume, the news stories driving it and a representative image. The trending endpoint lists the current trending searches for a country (term-centric, ranked, with volume and the top news story); the news endpoint flattens the news articles powering those trends (article-centric — the "what is driving search right now" view, each article tagged with its trend, source and link); and the geos endpoint lists the supported countries. The real-time search-interest / trends-discovery layer for news, marketing, SEO, social-listening and content tools. Distinct from wiki-pageview and platform-specific trend APIs — this is Google web-search trends. Live from Google Trends; short cache only.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/googletrends-api/..."
```

## Pricing
- **Free** (Free) — 11,000 calls/Mo, 3 req/s
- **Starter** ($7/Mo) — 205,000 calls/Mo, 10 req/s
- **Pro** ($24/Mo) — 1,050,000 calls/Mo, 25 req/s
- **Scale** ($69/Mo) — 6,400,000 calls/Mo, 60 req/s

## Endpoints

### Trending

#### `GET /v1/trending` — Current trending searches for a country

**Parameters:**
- `geo` (query, optional, string) — 2-letter country code Example: `US`
- `limit` (query, optional, string) — Max trends (1-50) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/googletrends-api/v1/trending?geo=US&limit=25"
```

**Response:**
```json
{
    "data": {
        "geo": "US",
        "note": "The current trending Google searches in a country, ranked — each with its approximate search volume, a representative image, when it started trending and the top news story driving it. Pass geo (a 2-letter country code, default US). The real-time pulse of what a country is searching for.",
        "count": 10,
        "source": "Google Trends",
        "trends": [
            {
                "rank": 1,
                "title": "real madrid",
                "picture": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSwP9gP3K58I_0rsMUZdio-Pwx9A6oYMV-1Rv_VGwhz0w-BZPeoniWbdghvDlU",
                "pub_date": "Sun, 14 Jun 2026 09:50:00 -0700",
                "top_news": {
                    "url": "https://www.marca.com/futbol/real-madrid/2026/06/14/real-madrid-ata-cucurella.html",
                    "title": "El Real Madrid ata a Cucurella",
                    "source": "MARCA"
                },
                "news_count": 3,
                "approx_traffic": "1000+"
            },
            {
                "rank": 2,
                "title": "aruba",
                "picture": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSBrqzdOs9PKYK6GVQyOG81GK2yFoBCOufzFIG8vIHIZ5GPDoCKF-ZOGDidplg",
                "pub_date": "Sun, 14 Jun 2026 09:50:00 -0700",
                "top_news": {
                    "url": "https://creators.yahoo.com/lifestyle/story/i-stayed-at-one-of-arubas-best-value-resorts--and
…(truncated, see openapi.json for full schema)
```

### News

#### `GET /v1/news` — News articles driving the current trends

**Parameters:**
- `geo` (query, optional, string) — 2-letter country code Example: `US`
- `limit` (query, optional, string) — Max articles (1-100) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/googletrends-api/v1/news?geo=US&limit=30"
```

**Response:**
```json
{
    "data": {
        "geo": "US",
        "note": "The news stories powering the current trending searches in a country — the articles people are reading that drive each trend, each tagged with its trend, source and link. The article-centric view: what news is driving search right now. Pass geo (default US).",
        "count": 28,
        "source": "Google Trends",
        "articles": [
            {
                "url": "https://www.marca.com/futbol/real-madrid/2026/06/14/real-madrid-ata-cucurella.html",
                "title": "El Real Madrid ata a Cucurella",
                "trend": "real madrid",
                "source": "MARCA",
                "picture": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSwP9gP3K58I_0rsMUZdio-Pwx9A6oYMV-1Rv_VGwhz0w-BZPeoniWbdghvDlU",
                "snippet": null
            },
            {
                "url": "https://as.com/futbol/primera/el-real-madrid-negocia-por-cucurella-f202606-n/",
                "title": "Cucurella, pie y medio en el Real Madrid",
                "trend": "real madrid",
                "source": "Diario AS",
                "picture": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQiVpA2MYGiMdRAEPQq957Qaak8ERrc3IW2UuOIV409BwpikSW0pUGhHTqIHM8",
                "snippet": null
            },
            {
                "url": "https://www.sport.es/es/noticias/real-madrid/acuerdo-total-madrid-fichar-marc-131392810",
                "title": "¡Acuerdo total del Madrid para fichar a M
…(truncated, see openapi.json for full schema)
```

### Geos

#### `GET /v1/geos` — Supported country codes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/googletrends-api/v1/geos"
```

**Response:**
```json
{
    "data": {
        "geos": [
            "US",
            "GB",
            "DE",
            "FR",
            "ES",
            "IT",
            "NL",
            "CA",
            "AU",
            "BR",
            "MX",
            "AR",
            "JP",
            "KR",
            "IN",
            "ID",
            "TR",
            "RU",
            "PL",
            "SE",
            "ZA",
            "NG",
            "SA",
            "AE",
            "SG"
        ],
        "note": "The country codes supported by the trending and news endpoints — 2-letter ISO 3166-1 country codes. The feed also accepts other valid country codes beyond this common list.",
        "count": 25,
        "source": "Google Trends"
    },
    "meta": {
        "timestamp": "2026-06-14T17:03:40.785Z",
        "request_id": "a6b155cd-b534-45da-8c13-c2c8ba3a28f9"
    },
    "status": "ok",
    "message": "Geos retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/googletrends-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "top_us_trend": "real madrid"
        },
        "source": "Google Trends public Daily Search Trends RSS (trends.google.com/trending/rss), keyless",
        "service": "googletrends-api",
        "endpoints": {
            "GET /v1/geos": "Supported country codes.",
            "GET /v1/meta": "This document.",
            "GET /v1/news": "News articles driving the current trends (geo, limit).",
            "GET /v1/trending": "Current trending searches for a country (geo, limit)."
        },
        "description": "Live trending Google searches by country with no key: the current trending searches for any country (term-centric, with search volume and top news), the news articles driving those trends (article-centric), and the list of supported countries. The real-time search-interest / trends-discovery layer for news, marketing, SEO and social-listening tools. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:03:40.876Z",
        "request_id": "1f164f73-020f-49ad-a79c-e0f9412a7f94"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/googletrends-api
OpenAPI spec: https://www.oanor.com/api/googletrends-api/openapi.json