Google Trends · Crawlbase Dokumentation

API-Verwendung

Fügen Sie &scraper=google-trends zu einem Crawling API-Request hinzu. URL-kodieren Sie die Ziel-URL im Parameter url. Filter wie geo, Zeitraum und Kategorie 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/trending?geo=AE-DU' \
  --data-urlencode 'scraper=google-trends' -G
from crawlbase import CrawlingAPI

api = CrawlingAPI({'token': 'YOUR_TOKEN'})
res = api.get(
    'https://trends.google.com/trending?geo=AE-DU',
    {'scraper': 'google-trends'}
)

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/trending?geo=AE-DU',
  { scraper: 'google-trends' }
);
const data = JSON.parse(res.body);
require 'crawlbase'
api = Crawlbase::API.new(token: 'YOUR_TOKEN')

res = api.get('https://trends.google.com/trending?geo=AE-DU', scraper: 'google-trends')
data = JSON.parse(res.body)

Beispiel-Eingabe-URL

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

https://trends.google.com/trending?geo=AE-DU

Response-Struktur

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

trends

array

Trend-Suchanfragen auf der Seite, sortiert nach Position.

trends[].position

integer

Rang des Trends innerhalb der Seite (1-basiert).

trends[].title

string

Trend-Suchanfrage, wie sie auf der Google Trends-Seite erscheint.

trends[].searchVolume

string

Abgekürztes Suchvolumen für den Trend (zum Beispiel 20K+, 1M+).

trends[].searchVolumeText

string

Lokalisiertes, menschenlesbares Suchvolumen-Label (zum Beispiel 20K+ searches).

trends[].increasePercentage

string

Aktueller Anstieg des Suchinteresses, wie auf der Seite angezeigt.

trends[].started

string

Wann der Trend begann zu steigen, als relative Zeitangabe (zum Beispiel 6 hours ago).

trends[].status

string

Trend-Status, wie von Google angezeigt (typischerweise Active oder Lasted).

trends[].trendBreakdown

array<string>

Verwandte Unterabfragen, die Google unter diesem Trend gruppiert.

trends[].trendBreakdownMoreCount

integer

Anzahl zusätzlicher Unterabfragen über die in trendBreakdown aufgeführten hinaus.

trendsCount

integer

Gesamtzahl der in trends zurückgegebenen Trends.

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 die Trends eingegrenzt sind.

filters.timeRange

string

Zeitraum-Label, nach dem die Seite gefiltert ist (zum Beispiel Past 7 days).

filters.category

string

Kategoriefilter-Label (zum Beispiel All categories).

filters.trendType

string

Trend-Typ-Filter-Label (zum Beispiel All trends).

filters.sortBy

string

Sortierreihenfolge-Label (zum Beispiel By relevance, By search volume).

filters.updatedAtText

string

Lokalisiertes Label, das anzeigt, wann die Seite zuletzt von Google aktualisiert wurde.

pagination

object

Pagination-Status für den aktuellen Request.

pagination.currentPage

integer

Seitenindex der aktuellen Response (1-basiert).

pagination.itemsPerPage

integer

Anzahl der Trends, die Google pro Seite zurückgibt.

pagination.totalItems

integer

Gesamtzahl der über alle Seiten verfügbaren Trends für die aktuellen Filter.

pagination.hasNextPage

boolean

true, wenn weitere Trends auf einer nachfolgenden Seite verfügbar sind.

pagination.hasPreviousPage

boolean

true, wenn eine vorherige Seite verfügbar ist.

Beispiel-Response

{
  "trends": [
    {
      "position": 1,
      "title": "al maktoum international airport (dwc)",
      "searchVolume": "20K+",
      "searchVolumeText": "20K+ searches",
      "increasePercentage": "600%",
      "started": "6 hours ago",
      "status": "Active",
      "trendBreakdown": ["dubai international airport"],
      "trendBreakdownMoreCount": 0
    }
  ],
  "trendsCount": 5,
  "filters": {
    "geo": "Dubai",
    "timeRange": "Past 7 days",
    "category": "All categories",
    "trendType": "All trends",
    "sortBy": "By relevance",
    "updatedAtText": "Updated Jun 2, 2:56 PM"
  },
  "pagination": {
    "currentPage": 1,
    "itemsPerPage": 25,
    "totalItems": 25,
    "hasNextPage": false,
    "hasPreviousPage": false
  }
}