crawlbaseDocs
Anmelden

API-Verwendung

Fügen Sie &scraper=google-trends-explore zu einem Crawling API-Request hinzu. URL-kodieren Sie die Ziel-URL im Parameter url. Filter wie geo, Zeitraum, Kategorie und Suchtyp werden als Query-String-Parameter direkt an die Google Trends-URL übergeben.

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)

Beispiel-Eingabe-URL

Die im Parameter url übergebene URL (zur besseren Lesbarkeit URL-dekodiert):

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

Response-Struktur

JSON-Response-Body. Feldtypen können null sein, wenn die Quellseite den Wert nicht enthält.

topic
string
Aufgelöstes Themen-Label für die Explore-Abfrage (ein Knowledge-Graph-Themenname, oder der wörtliche Suchbegriff, wenn kein Thema zugeordnet wird).
filters
object
Filterstatus, der auf der Seite reflektiert wird, dekodiert aus der Google Trends-URL.
filters.geo
string
Aufgelöstes Geografie-Label (Land oder Subregion), auf das der Vergleich eingegrenzt ist. Standardmäßig Worldwide, wenn kein geo gesetzt ist.
filters.timeRange
string
Zeitraum-Label, nach dem der Vergleich gefiltert ist (zum Beispiel Past 12 months, Past 7 days).
filters.category
string
Kategoriefilter-Label (zum Beispiel All categories).
filters.searchType
string
Suchtyp-Filter-Label (zum Beispiel Web Search, YouTube Search).
filters.description
string
Menschenlesbare Zusammenfassung der aktiven Filter (typischerweise geo verbunden mit timeRange).
interestOverTime
object
Interesse-über-Zeit-Chart-Block.
interestOverTime.title
string
Abschnittsüberschrift, wie von Google gerendert (typischerweise Interest over time).
interestOverTime.timeline
array
Zeitreihen-Punkte für das Thema, chronologisch sortiert.
interestOverTime.timeline[].date
string
Lokalisiertes Datums-Label für den Datenpunkt.
interestOverTime.timeline[].value
number
Normalisierter Interesse-Score für den Datenpunkt, auf einer Skala von 0-100, wobei 100 die Spitzenpopularität für den Zeitraum darstellt.
interestOverTime.timelineCount
integer
Gesamtzahl der Punkte in timeline.
interestBySubregion
object
Interesse-nach-Subregion-Block (Land, Subregion, Metro oder Stadt, abhängig vom aktiven geo).
interestBySubregion.title
string
Abschnittsüberschrift, wie von Google gerendert (typischerweise Interest by region, Interest by sub-region, etc.).
interestBySubregion.view
string
Aktiver View-Tab (typischerweise Top oder Rising).
interestBySubregion.totalItems
integer
Gesamtzahl der über alle Seiten verfügbaren Regionen.
interestBySubregion.paginationText
string
Lokalisierte Pagination-Zusammenfassung (zum Beispiel Showing 1-5 of 87 regions).
interestBySubregion.items
array
Regionen auf der aktuellen Seite, sortiert nach Position.
interestBySubregion.items[].position
integer
Rang der Region innerhalb der Response (1-basiert).
interestBySubregion.items[].name
string
Regionsname, wie von Google angezeigt.
interestBySubregion.items[].value
number
Normalisierter Interesse-Score für die Region auf einer Skala von 0-100.
relatedTopics
object
Verwandte-Themen-Block.
relatedTopics.title
string
Abschnittsüberschrift, wie von Google gerendert (typischerweise Related topics).
relatedTopics.view
string
Aktiver View-Tab (typischerweise Top oder Rising).
relatedTopics.items
array
Verwandte Themen auf der aktuellen Seite, sortiert nach Position.
relatedTopics.items[].position
integer
Rang des Themas innerhalb der Response (1-basiert).
relatedTopics.items[].name
string
Themenname, wie von Google angezeigt.
relatedTopics.items[].value
string
Score-Label, wie von Google angezeigt: eine prozentuale Wachstums-Zeichenkette (zum Beispiel +250%) in der Rising-Ansicht, oder Breakout für Neueinsteiger; ein relativer Score in der Top-Ansicht.
relatedTopics.items[].link
string
Google Trends Explore-URL für das verwandte Thema.
relatedQueries
object
Verwandte-Suchanfragen-Block.
relatedQueries.title
string
Abschnittsüberschrift, wie von Google gerendert (typischerweise Related queries).
relatedQueries.view
string
Aktiver View-Tab (typischerweise Top oder Rising).
relatedQueries.items
array
Verwandte Suchanfragen auf der aktuellen Seite, sortiert nach Position.
relatedQueries.items[].position
integer
Rang der Suchanfrage innerhalb der Response (1-basiert).
relatedQueries.items[].name
string
Suchanfrage, wie von Google angezeigt.
relatedQueries.items[].value
string
Score-Label, wie von Google angezeigt: eine prozentuale Wachstums-Zeichenkette (zum Beispiel +250%) in der Rising-Ansicht, oder Breakout für Neueinsteiger; ein relativer Score in der Top-Ansicht.
relatedQueries.items[].link
string
Google Trends Explore-URL für die verwandte Suchanfrage.

Beispiel-Response

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