crawlbase文档
登录

Google Trends Explore

将 Google Trends Explore 页面解析为结构化的主题兴趣随时间变化、子区域兴趣分布、相关主题和相关查询。

API 用法

在 Crawling API 请求中添加 &scraper=google-trends-explore。在 url 参数中传入经过 URL 编码的目标 URL。geo、时间范围、类别、搜索类型等筛选条件作为查询字符串参数附加在 Google Trends URL 本身。

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 查询的解析后主题标签（知识图谱主题名称，或在未匹配到主题时为字面搜索词）。
filters
object
从 Google Trends URL 解码得到的、页面所反映的筛选状态。
filters.geo
string
对比所限定的解析后地理区域标签（国家或子区域）。当未设置 geo 时默认为 Worldwide。
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 显示的分值标签：在 Rising 视图下为百分比增长字符串（例如 +250%），新进入者显示为 Breakout；在 Top 视图下为相对分数。
relatedTopics.items[].link
string
该相关主题的 Google Trends Explore URL。
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 显示的分值标签：在 Rising 视图下为百分比增长字符串(例如 +250%)，新进入者显示为 Breakout；在 Top 视图下为相对分数。
relatedQueries.items[].link
string
该相关查询的 Google Trends Explore URL。

响应示例

{
  "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"
      }
    ]
  }
}