~/business/google-trends-scraper

Google Trends Scraper — Kata Kunci, Pencarian Terkait & Peringkat Kategori

Google Trends untuk kata kunci apa pun — minat dari waktu ke waktu, pencarian terkait teratas dan meningkat, serta minat menurut wilayah — dan pencarian teratas serta meningkat dari kategori mana pun di antara 928 kategori Google, di negara, wilayah, atau area metro AS mana pun, untuk rentang waktu apa pun yang disediakan Google.

tren pencarian TypeScript Global

run di Apify

proooxy/google-trends-scraper — spec

kategoribusiness / tren pencarian

bahasaTypeScript

stackTypeScript

pasarGlobal

outputJSON bersih, siap-RAG

fitur utama

Lookup kata kunci: minat dari waktu ke waktu, pencarian terkait teratas dan meningkat dengan Breakout ditandai, serta minat menurut wilayah atau kota, dalam satu baris

Peringkat kategori: pencarian teratas dan meningkat dari kategori mana pun di antara 928 kategori Google, hingga level ketiga, atau dari semuanya

Tempat mana pun: satu negara, wilayah di dalamnya (US-CA, GB-SCT), area metro AS (US-CA-807), atau seluruh dunia

Setiap rentang waktu yang ditawarkan Google, dari satu jam terakhir hingga semuanya sejak 2004, beberapa sekaligus dalam satu run

Kata kunci dicari di dalam satu kategori untuk membedakan satu makna dari makna lain: jaguar sebagai mobil

Setiap lookup dan setiap pencarian yang diperingkat mempertahankan key-nya dari run ke run, sehingga run terjadwal terakumulasi menjadi sebuah riwayat

Ringkasan run yang membedakan 'tidak ada data' dari 'gagal'; permintaan yang ditolak Google dicoba lagi di akhir run

use case

Perencanaan SEO dan konten: pencarian yang meningkat di seputar suatu topik, dan wilayah tempat topik itu paling banyak diminati
Riset produk dan pasar: apakah minat pada produk, brand, atau kategori naik, stagnan, atau kembali setiap musim
Pemantauan kategori: apa yang dicari orang di Shopping, Travel, atau niche apa pun, bulan demi bulan
Pipeline data dan dashboard: lookup terjadwal untuk berbagai kata kunci, pasar, dan rentang waktu
Memberi agent AI data Google Trends lewat MCP server milik Apify

parameter input

Parameter	Tipe	Wajib	Deskripsi
`keywords`	array	opsional	Kata kunci yang akan di-lookup, masing-masing secara terpisah, di setiap tempat dan rentang waktu
`keywordCategory`	string	opsional	Lookup kata kunci di dalam satu kategori: ID, nama, atau path-nya
`categories`	array	opsional	Kategori yang pencarian teratas dan meningkatnya akan dibaca: nama, path, ID, atau 0 untuk semua kategori sekaligus
`subcategories`	boolean	opsional	Beri peringkat juga pada subkategori tiap kategori, hingga level ketiga
`allCategories`	boolean	opsional	Beri peringkat pada semua 928 kategori: sekitar satu setengah jam untuk setiap tempat dan rentang waktu
`countries`	array	opsional	Kode negara, wilayah (US-CA), area metro AS (US-CA-807), atau seluruh dunia
`windows`	array	opsional	1h, 4h, 24h, 7d, 30d, 90d, 12m, 5y, atau all sejak 2004; default-nya 12 bulan terakhir
`maxItemsPerList`	number	opsional	Paling banyak sekian pencarian dari setiap daftar teratas atau meningkat
`maxItems`	number	opsional	Berhenti setelah sekian hasil dalam seluruh run
`proxy`	object	opsional	Dipakai untuk setiap permintaan; default-nya residential proxy Apify

Contoh Keluaran

Lookup kata kunci bitcoin di Amerika Serikat selama 12 bulan terakhir:

 1{
 2  "recordType": "lookup",
 3  "itemKey": "google|lookup|US|12m|all|bitcoin",
 4  "keyword": "bitcoin",
 5  "geo": "US",
 6  "geoScope": "country",
 7  "window": "12m",
 8  "category": null,
 9  "status": "ok",
10  "reason": null,
11  "points": [
12    { "time": "2025-10-05T00:00:00.000Z", "value": 37, "hasData": true, "partial": false },
13    { "time": "2025-10-12T00:00:00.000Z", "value": 40, "hasData": true, "partial": false },
14    { "time": "2026-09-27T00:00:00.000Z", "value": 16, "hasData": true, "partial": false },
15    { "time": "2026-10-04T00:00:00.000Z", "value": 17, "hasData": true, "partial": true }
16  ],
17  "relatedQueries": {
18    "top": [
19      { "query": "bitcoin price", "value": 100, "label": "100", "breakout": false },
20      { "query": "bitcoin stock", "value": 18, "label": "18", "breakout": false }
21    ],
22    "rising": [
23      { "query": "spcx stock", "value": 14250, "label": "Breakout", "breakout": true },
24      { "query": "spcx stock price", "value": 12750, "label": "Breakout", "breakout": true }
25    ]
26  },
27  "regions": [
28    { "code": "US-WY", "name": "Wyoming", "value": 100 },
29    { "code": "US-NV", "name": "Nevada", "value": 51 }
30  ],
31  "observedAt": "2026-10-09T07:32:28.150Z",
32  "url": "https://trends.google.com/trends/explore?date=today+12-m&geo=US&q=bitcoin"
33}

Dipangkas agar ringkas: baris ini juga membawa platform dan geoRequested, dan baris lengkapnya memiliki satu titik untuk setiap minggu, 25 pencarian teratas dan 25 pencarian meningkat, serta setiap negara bagian. Sebaliknya, peringkat kategori berupa satu baris per pencarian, dengan list diisi explore_top atau explore_rising: pada 9 Oktober 2026, quince memimpin pencarian meningkat di kategori Shopping di Amerika Serikat selama 12 bulan, sebesar +80%.

Tips

Beri run untuk semua kategori timeout dua jam atau lebih. Seluruh 929 peringkat di satu tempat untuk satu rentang waktu memakan waktu sekitar satu setengah jam; run yang mendekati batas waktunya berhenti sendiri dan menandai sisanya not_reached.
Lookup yang tidak ada datanya di Google tetap menjadi satu baris, dengan status: "not_available" dan alasan dari Google, dan tidak dikenakan biaya.
Bedakan makna dengan kategori kata kunci: jaguar di Autos & Vehicles adalah mobil, bukan hewan.
Baca record SUMMARY dari run untuk membedakan kata kunci tanpa data dari lookup yang tidak bisa dibaca.

faq

Mengapa titik tertinggi selalu 100?

Google menskalakan setiap lookup ke titik tertingginya sendiri, jadi angkanya adalah minat relatif, bukan jumlah pencarian. Dua lookup tidak berada pada skala yang sama.

Apa itu Breakout?

Penanda dari Google, sebagai pengganti persentase, untuk pencarian terkait yang naik lebih dari 5.000%. Di antarmuka Google berbahasa Indonesia, penanda ini tampil sebagai 'Pesat'. Nilainya adalah kenaikan yang diberikan Google bersamanya, seperti 14250.

Rentang waktu mana yang punya peringkat kategori?

Hanya 7 hari, 30 hari, 90 hari, dan 12 bulan terakhir, dan hanya hingga level ketiga pohon kategori Google. Peringkat yang diminta untuk rentang lain dicatat di ringkasan run sebagai not_available dan tidak dikenakan biaya.

Apakah topik terkait disertakan?

Tidak: Google mengembalikannya kosong untuk permintaan otomatis. Pencarian terkait disertakan, baik yang teratas maupun yang meningkat.