Google Trends Scraper
/compare-timeframesCompare Timeframes
Compare one keyword across 2-5 periods on one scale, aligned point by point (e.g. this year vs last year).
QUERY PARAMS
One search term or Google topic id (from /autocomplete), or a Google Trends explore link with one keyword.
Examples:
- Term:
super bowl - Topic id:
/m/0dl567(Taylor Swift)
2-5 comma-separated timeframes (each takes any timeframe value: a name like past_12_months, or a range YYYY-MM-DD YYYY-MM-DD).
Example: 2024-01-01 2024-12-31,2025-01-01 2025-12-31
Where to measure: a country, a region, a US metro area (DMA) or worldwide (see /geos for every code). A trends.google.com link with ?geo= works too.
Default: worldwide
Examples: US, US-CA (California), US-CA-803 (Los Angeles), GB-ENG (England)
Google Trends category id that narrows the searches to one topic area (see /categories).
Default: 0 (all categories)
Examples: 71 (Food & Drink), 5 (Computers & Electronics), 20 (Sports)
Which Google search to measure.
Default: web
Allowed values: web, images, news, youtube, shopping
Language for names and labels: an ISO 639-1 code or a locale.
Default: en
Examples: en, de, ja, pt-BR
{
"keyword": {
"keyword": "super bowl",
"name": "super bowl",
"is_topic": false
},
"geo": {
"code": null,
"name": "Worldwide"
},
"category": {
"id": 0,
"name": "All categories"
},
"property": "web",
"resolution": "week",
"timeframes": [
{
"value": "2024-01-01 2024-12-31",
"start": "2024-01-01",
"end": "2024-12-31",
"average": 4
},
{
"value": "2025-01-01 2025-12-31",
"start": "2025-01-01",
"end": "2025-12-31",
"average": 4
}
],
"timeline": [
{
"position": 1,
"points": [
{
"date": "2023-12-31",
"value": 3,
"is_partial": false
},
{
"date": "2024-12-29",
"value": 4,
"is_partial": false
}
]
},
{
"position": 2,
"points": [
{
"date": "2024-01-07",
"value": 5,
"is_partial": false
},
{
"date": "2025-01-05",
"value": 5,
"is_partial": false
}
]
},
{
"position": 3,
"points": [
{
"date": "2024-01-14",
"value": 7,
"is_partial": false
},
{
"date": "2025-01-12",
"value": 6,
"is_partial": false
}
]
},
{
"position": 4,
"points": [
{
"date": "2024-01-21",
"value": 10,
"is_partial": false
},
{
"date": "2025-01-19",
"value": 9,
"is_partial": false
}
]
},
{
"position": 5,
"points": [
{
"date": "2024-01-28",
"value": 21,
"is_partial": false
},
{
"date": "2025-01-26",
"value": 20,
"is_partial": false
}
]
},
{
"position": 6,
"points": [
{
"date": "2024-02-04",
"value": 25,
"is_partial": false
},
{
"date": "2025-02-02",
"value": 25,
"is_partial": false
}
]
},
{
"position": 7,
"points": [
{
"date": "2024-02-11",
"value": 100,
"is_partial": false
},
{
"date": "2025-02-09",
"value": 91,
"is_partial": false
}
]
},
{
"position": 8,
"points": [
{
"date": "2024-02-18",
"value": 3,
"is_partial": false
},
{
"date": "2025-02-16",
"value": 3,
"is_partial": false
}
]
},
{
"position": 9,
"points": [
{
"date": "2024-02-25",
"value": 1,
"is_partial": false
},
{
"date": "2025-02-23",
"value": 2,
"is_partial": false
}
]
},
{
"position": 10,
"points": [
{
"date": "2024-03-03",
"value": 1,
"is_partial": false
},
{
"date": "2025-03-02",
"value": 1,
"is_partial": false
}
]
},
{
"position": 11,
"points": [
{
"date": "2024-03-10",
"value": 1,
"is_partial": false
},
{
"date": "2025-03-09",
"value": 1,
"is_partial": false
}
]
},
{
"position": 12,
"points": [
{
"date": "2024-03-17",
"value": 1,
"is_partial": false
},
{
"date": "2025-03-16",
"value": 1,
"is_partial": false
}
]
},
{
"position": 13,
"points": [
{
"date": "2024-03-24",
"value": 1,
"is_partial": false
},
{
"date": "2025-03-23",
"value": 1,
"is_partial": false
}
]
},
{
"position": 14,
"points": [
{
"date": "2024-03-31",
"value": 1,
"is_partial": false
},
{
"date": "2025-03-30",
"value": 1,
"is_partial": false
}
]
},
{
"position": 15,
"points": [
{
"date": "2024-04-07",
"value": 1,
"is_partial": false
},
{
"date": "2025-04-06",
"value": 1,
"is_partial": false
}
]
},
{
"position": 16,
"points": [
{
"date": "2024-04-14",
"value": 1,
"is_partial": false
},
{
"date": "2025-04-13",
"value": 1,
"is_partial": false
}
]
},
{
"position": 17,
"points": [
{
"date": "2024-04-21",
"value": 1,
"is_partial": false
},
{
"date": "2025-04-20",
"value": 1,
"is_partial": false
}
]
},
{
"position": 18,
"points": [
{
"date": "2024-04-28",
"value": 1,
"is_partial": false
},
{
"date": "2025-04-27",
"value": 1,
"is_partial": false
}
]
},
{
"position": 19,
"points": [
{
"date": "2024-05-05",
"value": 1,
"is_partial": false
},
{
"date": "2025-05-04",
"value": 1,
"is_partial": false
}
]
},
{
"position": 20,
"points": [
{
"date": "2024-05-12",
"value": 1,
"is_partial": false
},
{
"date": "2025-05-11",
"value": 1,
"is_partial": false
}
]
},
{
"position": 21,
"points": [
{
"date": "2024-05-19",
"value": 1,
"is_partial": false
},
{
"date": "2025-05-18",
"value": 1,
"is_partial": false
}
]
},
{
"position": 22,
"points": [
{
"date": "2024-05-26",
"value": 1,
"is_partial": false
},
{
"date": "2025-05-25",
"value": 1,
"is_partial": false
}
]
},
{
"position": 23,
"points": [
{
"date": "2024-06-02",
"value": 1,
"is_partial": false
},
{
"date": "2025-06-01",
"value": 1,
"is_partial": false
}
]
},
{
"position": 24,
"points": [
{
"date": "2024-06-09",
"value": 1,
"is_partial": false
},
{
"date": "2025-06-08",
"value": 1,
"is_partial": false
}
]
},
{
"position": 25,
"points": [
{
"date": "2024-06-16",
"value": 1,
"is_partial": false
},
{
"date": "2025-06-15",
"value": 1,
"is_partial": false
}
]
},
{
"position": 26,
"points": [
{
"date": "2024-06-23",
"value": 1,
"is_partial": false
},
{
"date": "2025-06-22",
"value": 1,
"is_partial": false
}
]
},
{
"position": 27,
"points": [
{
"date": "2024-06-30",
"value": 1,
"is_partial": false
},
{
"date": "2025-06-29",
"value": 1,
"is_partial": false
}
]
},
{
"position": 28,
"points": [
{
"date": "2024-07-07",
"value": 1,
"is_partial": false
},
{
"date": "2025-07-06",
"value": 1,
"is_partial": false
}
]
},
{
"position": 29,
"points": [
{
"date": "2024-07-14",
"value": 1,
"is_partial": false
},
{
"date": "2025-07-13",
"value": 1,
"is_partial": false
}
]
},
{
"position": 30,
"points": [
{
"date": "2024-07-21",
"value": 1,
"is_partial": false
},
{
"date": "2025-07-20",
"value": 1,
"is_partial": false
}
]
},
{
"position": 31,
"points": [
{
"date": "2024-07-28",
"value": 1,
"is_partial": false
},
{
"date": "2025-07-27",
"value": 1,
"is_partial": false
}
]
},
{
"position": 32,
"points": [
{
"date": "2024-08-04",
"value": 1,
"is_partial": false
},
{
"date": "2025-08-03",
"value": 1,
"is_partial": false
}
]
},
{
"position": 33,
"points": [
{
"date": "2024-08-11",
"value": 1,
"is_partial": false
},
{
"date": "2025-08-10",
"value": 1,
"is_partial": false
}
]
},
{
"position": 34,
"points": [
{
"date": "2024-08-18",
"value": 1,
"is_partial": false
},
{
"date": "2025-08-17",
"value": 1,
"is_partial": false
}
]
},
{
"position": 35,
"points": [
{
"date": "2024-08-25",
"value": 1,
"is_partial": false
},
{
"date": "2025-08-24",
"value": 1,
"is_partial": false
}
]
},
{
"position": 36,
"points": [
{
"date": "2024-09-01",
"value": 1,
"is_partial": false
},
{
"date": "2025-08-31",
"value": 2,
"is_partial": false
}
]
},
{
"position": 37,
"points": [
{
"date": "2024-09-08",
"value": 2,
"is_partial": false
},
{
"date": "2025-09-07",
"value": 2,
"is_partial": false
}
]
},
{
"position": 38,
"points": [
{
"date": "2024-09-15",
"value": 1,
"is_partial": false
},
{
"date": "2025-09-14",
"value": 2,
"is_partial": false
}
]
},
{
"position": 39,
"points": [
{
"date": "2024-09-22",
"value": 1,
"is_partial": false
},
{
"date": "2025-09-21",
"value": 2,
"is_partial": false
}
]
},
{
"position": 40,
"points": [
{
"date": "2024-09-29",
"value": 1,
"is_partial": false
},
{
"date": "2025-09-28",
"value": 5,
"is_partial": false
}
]
},
{
"position": 41,
"points": [
{
"date": "2024-10-06",
"value": 1,
"is_partial": false
},
{
"date": "2025-10-05",
"value": 3,
"is_partial": false
}
]
},
{
"position": 42,
"points": [
{
"date": "2024-10-13",
"value": 1,
"is_partial": false
},
{
"date": "2025-10-12",
"value": 2,
"is_partial": false
}
]
},
{
"position": 43,
"points": [
{
"date": "2024-10-20",
"value": 1,
"is_partial": false
},
{
"date": "2025-10-19",
"value": 2,
"is_partial": false
}
]
},
{
"position": 44,
"points": [
{
"date": "2024-10-27",
"value": 1,
"is_partial": false
},
{
"date": "2025-10-26",
"value": 1,
"is_partial": false
}
]
},
{
"position": 45,
"points": [
{
"date": "2024-11-03",
"value": 1,
"is_partial": false
},
{
"date": "2025-11-02",
"value": 2,
"is_partial": false
}
]
},
{
"position": 46,
"points": [
{
"date": "2024-11-10",
"value": 1,
"is_partial": false
},
{
"date": "2025-11-09",
"value": 1,
"is_partial": false
}
]
},
{
"position": 47,
"points": [
{
"date": "2024-11-17",
"value": 1,
"is_partial": false
},
{
"date": "2025-11-16",
"value": 2,
"is_partial": false
}
]
},
{
"position": 48,
"points": [
{
"date": "2024-11-24",
"value": 2,
"is_partial": false
},
{
"date": "2025-11-23",
"value": 2,
"is_partial": false
}
]
},
{
"position": 49,
"points": [
{
"date": "2024-12-01",
"value": 2,
"is_partial": false
},
{
"date": "2025-11-30",
"value": 2,
"is_partial": false
}
]
},
{
"position": 50,
"points": [
{
"date": "2024-12-08",
"value": 2,
"is_partial": false
},
{
"date": "2025-12-07",
"value": 2,
"is_partial": false
}
]
},
{
"position": 51,
"points": [
{
"date": "2024-12-15",
"value": 2,
"is_partial": false
},
{
"date": "2025-12-14",
"value": 2,
"is_partial": false
}
]
},
{
"position": 52,
"points": [
{
"date": "2024-12-22",
"value": 3,
"is_partial": false
},
{
"date": "2025-12-21",
"value": 3,
"is_partial": false
}
]
},
{
"position": 53,
"points": [
{
"date": "2024-12-29",
"value": 4,
"is_partial": false
},
{
"date": "2025-12-28",
"value": 4,
"is_partial": false
}
]
}
]
}