crawlbaseДокументация
Войти

Google Trends Explore

Разбирайте страницу Google Trends Explore в структурированные данные: интерес к теме со временем, интерес по субрегионам, связанные темы и связанные запросы.

Использование API

Добавьте &scraper=google-trends-explore к запросу Crawling API. Передайте целевой URL в параметре url в URL-кодированном виде. Фильтры, такие как geo, временной диапазон, категория и тип поиска, передаются как параметры строки запроса в самом URL Google Trends.

curl 'https://api.crawlbase.com/?token=YOUR_TOKEN' \
  --data-urlencode 'url=https://trends.google.com/trends/explore?q=/g/11cs9m5kkd' \
  --data-urlencode 'scraper=google-trends-explore' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://trends.google.com/trends/explore?q=/g/11cs9m5kkd',
    {'scraper': 'google-trends-explore'}
)

import json
data = json.loads(res['body'])
const { CrawlingAPI } = require('crawlbase');
const api = new CrawlingAPI({ token: 'YOUR_TOKEN' });

const res = await api.get(
  'https://trends.google.com/trends/explore?q=/g/11cs9m5kkd',
  { scraper: 'google-trends-explore' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://trends.google.com/trends/explore?q=/g/11cs9m5kkd', scraper: 'google-trends-explore')
data = JSON.parse(res.body)

Пример входного URL

URL, передаваемый в параметре url (URL-декодированный для удобства чтения):

https://trends.google.com/trends/explore?q=/g/11cs9m5kkd

Структура ответа

Тело JSON-ответа. Типы полей могут быть null, если исходная страница не содержит значения.

topic
string
Распознанный ярлык темы для запроса Explore (название темы из Knowledge Graph или буквальный поисковый запрос, если ни одна тема не сопоставлена).
filters
object
Состояние фильтров, отражённое страницей и декодированное из URL Google Trends.
filters.geo
string
Распознанный географический ярлык (страна или субрегион), к которому привязано сравнение. По умолчанию Worldwide, если geo не задан.
filters.timeRange
string
Ярлык временного диапазона, по которому отфильтровано сравнение (например Past 12 months, Past 7 days).
filters.category
string
Ярлык фильтра категории (например All categories).
filters.searchType
string
Ярлык фильтра типа поиска (например Web Search, YouTube Search).
filters.description
string
Читаемое описание активных фильтров (обычно geo, соединённый с timeRange).
interestOverTime
object
Блок графика "интерес со временем".
interestOverTime.title
string
Заголовок раздела в том виде, как его отображает Google (обычно Interest over time).
interestOverTime.timeline
array
Точки временного ряда для темы, упорядоченные хронологически.
interestOverTime.timeline[].date
string
Локализованная подпись даты для точки данных.
interestOverTime.timeline[].value
number
Нормализованная оценка интереса для точки данных по шкале 0–100, где 100 — пик популярности за период.
interestOverTime.timelineCount
integer
Общее число точек в timeline.
interestBySubregion
object
Блок "интерес по субрегионам" (страна, субрегион, агломерация или город, в зависимости от активного geo).
interestBySubregion.title
string
Заголовок раздела в том виде, как его отображает Google (обычно Interest by region, Interest by sub-region и т.п.).
interestBySubregion.view
string
Активная вкладка представления (обычно Top или Rising).
interestBySubregion.totalItems
integer
Общее число регионов, доступных на всех страницах.
interestBySubregion.paginationText
string
Локализованная сводка пагинации (например Showing 1-5 of 87 regions).
interestBySubregion.items
array
Регионы на текущей странице, упорядоченные по позиции.
interestBySubregion.items[].position
integer
Позиция региона в ответе (начиная с 1).
interestBySubregion.items[].name
string
Название региона в том виде, как его отображает Google.
interestBySubregion.items[].value
number
Нормализованная оценка интереса для региона по шкале 0–100.
relatedTopics
object
Блок "связанные темы".
relatedTopics.title
string
Заголовок раздела в том виде, как его отображает Google (обычно Related topics).
relatedTopics.view
string
Активная вкладка представления (обычно Top или Rising).
relatedTopics.items
array
Связанные темы на текущей странице, упорядоченные по позиции.
relatedTopics.items[].position
integer
Позиция темы в ответе (начиная с 1).
relatedTopics.items[].name
string
Название темы в том виде, как его отображает Google.
relatedTopics.items[].value
string
Подпись оценки в том виде, как её отображает Google: строка процентного роста (например +250%) во вкладке Rising или Breakout для новичков; относительная оценка во вкладке Top.
relatedTopics.items[].link
string
URL Google Trends Explore для связанной темы.
relatedQueries
object
Блок "связанные запросы".
relatedQueries.title
string
Заголовок раздела в том виде, как его отображает Google (обычно Related queries).
relatedQueries.view
string
Активная вкладка представления (обычно Top или Rising).
relatedQueries.items
array
Связанные запросы на текущей странице, упорядоченные по позиции.
relatedQueries.items[].position
integer
Позиция запроса в ответе (начиная с 1).
relatedQueries.items[].name
string
Поисковый запрос в том виде, как его отображает Google.
relatedQueries.items[].value
string
Подпись оценки в том виде, как её отображает Google: строка процентного роста (например +250%) во вкладке Rising или Breakout для новичков; относительная оценка во вкладке Top.
relatedQueries.items[].link
string
URL Google Trends Explore для связанного запроса.

Пример ответа

{
  "topic": "YouTube Music",
  "filters": {
    "geo": "Worldwide",
    "timeRange": "Past 12 months",
    "category": "All categories",
    "searchType": "Web Search",
    "description": "Worldwide, Past 12 months"
  },
  "interestOverTime": {
    "title": "Interest over time",
    "timeline": [
      {
        "date": "Jun 15, 2025",
        "value": 100
      }
    ],
    "timelineCount": 53
  },
  "interestBySubregion": {
    "title": "Interest by region",
    "view": "Top",
    "totalItems": 87,
    "paginationText": "Showing 1-5 of 87 regions",
    "items": [
      {
        "position": 1,
        "name": "South Africa",
        "value": 100
      }
    ]
  },
  "relatedTopics": {
    "title": "Related topics",
    "view": "Rising",
    "items": [
      {
        "position": 1,
        "name": "Spotify - Topic",
        "value": "Breakout",
        "link": "https://trends.google.com/trends/explore?q=/g/11hy9l1k8h&date=today+12-m"
      }
    ]
  },
  "relatedQueries": {
    "title": "Related queries",
    "view": "Rising",
    "items": [
      {
        "position": 1,
        "name": "youtube muzica",
        "value": "+250%",
        "link": "https://trends.google.com/trends/explore?q=youtube+muzica&date=today+12-m"
      }
    ]
  }
}