How do I download related queries from Google Trends?
Launch the bot, review the required keyword field (it ships prefilled with an example term), and confirm. The launcher loads the Trends explore page, types your keyword into the search input, presses Enter, waits for the related queries widget export control, triggers it, and captures the CSV the page generates. The file lands in the run output location as related_query.csv with no further clicking.
What does the related_query.csv file contain?
Exactly what the platform export produces for the related queries widget: one row per related query, with the query text and the platform's own magnitude column - a rising percentage or a relative top index, depending on the widget state when the export fires. The bot does not reformat, rename columns, or add fields. Open it in Excel or Sheets as-is.
How many keywords can one run research?
One. Each run reads a single keyword value and produces one related_query.csv. For a list of seeds, run the launcher once per term and keep files named by keyword and date, or schedule repeated launches with your operating system scheduler, passing a different keyword each time.
Why did the run fail on the consent page?
The Trends page can present a consent or cookie interstitial before the explore input renders, particularly from EU addresses. This configuration ships no command to dismiss that interstitial, so the fill step times out and the run fails loudly with no CSV. Clear consent once in your regular browser, run from a region where the page renders directly, or extend the project with a consent-handling step.
Do I need a Google account to run it?
No. The bot reads the public explore experience as a logged-out visitor. If the platform presents a sign-in wall or verification challenge from your address, the run stops rather than attempting to authenticate; there are no credential fields anywhere in the configuration, by design.
Does it export rising or top related queries?
It captures whatever the export control of the related queries widget produces at the moment it fires, which reflects the widget state on a fresh page load. If you need the other mode deterministically, that is a small project edit - a click step on the toggle before the export wait - not a setting on this bot.
Does it collect exact search volume numbers?
No. The platform publishes relative signals - rising percentages and zero-to-one-hundred top indices - not absolute monthly search volumes, and the bot collects only what is published. Treat the CSV as directional research input, not as a volume database.
What happens when Google changes the page layout?
The selectors are pinned to current platform markup, so a redesign makes the wait step time out and the run ends with no file. Failure is loud: you get an error and an absent CSV, never a stale or fabricated spreadsheet. Check the selectors in the configuration against the live page and update them; that is the normal maintenance cost of a pinned-selector bot.
How often can I run the bot?
As often as your use case justifies at a human pace. There is no built-in limiter, so the polite pattern is a few runs per session with gaps between them, matching what a patient researcher would do. High-frequency looping from one address is what triggers verification challenges and blocks.
Can it schedule itself to run daily?
Not on its own - the configuration has no internal scheduler. Schedule the launcher with your operating system: Task Scheduler on Windows, cron on Linux, or launchd on macOS. Each scheduled launch re-reads the keyword input and writes a fresh related_query.csv.
Does the output include the interest over time chart?
No. The bot exports only the related queries widget. The interest-over-time chart has its own export control on the page, and adding it would be a project extension with a second wait-and-download step. The shipped configuration keeps one output file so every run stays predictable.
Does the bot need an internet connection to run?
Yes on first run: the launcher fetches its configuration by id from the backend at launch, so an internet connection is required at least the first time it starts.
Can I rename the downloaded file?
No. The downloaded file must keep its exact name - the filename carries the per-bot configuration id, and renaming it breaks the configuration fetch at launch.
