Google Trends Reliable: Series Without a Start Fee

Urlwright. Little tools for the web.

Interest over time, interest by region and related queries from the public Google Trends pages. Each keyword is its own series. There is no start fee. A keyword that comes back blocked is free.

No login. The actor does not collect personal data. It asks Google for the chart, then stores the numbers.

What it does

1. You pass one or more keywords. Each keyword is requested on its own, so the 0 to 100 scale is not shared with the others.
2. Interest over time (on by default) is one timeline.
3. Interest by region is one table of places.
4. Related queries and related topics are the top list and the rising list. A value Google labels Breakout is marked breakout.
5. Daily trends, off by default, reads the public daily trends feed for the geo once per run. You get the title and the traffic label.
6. Delta mode keeps a snapshot in a named key-value store. The next run, for the same keyword, geo, time range, category and property, writes only rising or breakout queries and topics that were not in that snapshot. A quiet day still writes the row, with an empty data list.
7. One blocked keyword does not fail the run. The row is status: blocked and nothing is billed for it.

Direct or datacenter proxy goes first. After an HTTP 429 the actor waits and tries again three times. If you listed the RESIDENTIAL proxy group, it then tries residential. If that still fails, the row is blocked.

robots.txt for UrlwrightBot is respected unless you turn that off.

Who it is for

Scheduled watches: run the actor on a timetable and use delta mode so the dataset shows what started rising. Also one-off checks of a few keywords, without a fee for a keyword Google refuses.

Input

The console prefills urlwright and sitemap, worldwide, the last 12 months, interest over time only.

{
  "keywords": ["urlwright", "sitemap"],
  "geo": "",
  "timeRange": "today 12-m",
  "category": 0,
  "property": "",
  "interestOverTime": true,
  "interestByRegion": false,
  "relatedQueries": false,
  "relatedTopics": false,
  "dailyTrends": false,
  "deltaMode": false,
  "deltaStoreName": "google-trends-delta",
  "respectRobotsTxt": true
}

geo empty is worldwide. A code such as US or US-CA limits the chart. timeRange is a preset (today 12-m, today 5-y, now 7-d, and the other presets in the field description) or two dates, YYYY-MM-DD YYYY-MM-DD. property empty is web search. youtube, news, images and froogle (Shopping) are the other properties. category 0 is all categories.

At most 25 keywords. A repeated keyword is kept once.

Output

One dataset row per keyword and output type. Daily trends is a single extra row, with an empty keyword. Every field is present. Unused fields are null.

{
  "schemaVersion": 1,
  "keyword": "urlwright",
  "geo": "",
  "timeRange": "today 12-m",
  "category": 0,
  "property": "",
  "type": "interestOverTime",
  "data": [
    { "timestamp": "1761436800", "date": "Oct 26, 2025", "axisDate": "Oct 26, 2025", "value": 62, "hasData": true, "partial": false }
  ],
  "fetchedAt": "2026-10-29T10:00:00.000Z",
  "status": "ok",
  "attempts": 1,
  "proxyTier": "none",
  "httpStatus": 200,
  "error": null,
  "charged": true,
  "chargedEvents": { "trend-series": 1, "delta-alert": 0 }
}

status is ok, partial or blocked. The latest timeline bucket is partial when Google marks that period as incomplete, and the row status follows. proxyTier is none, datacenter or residential. attempts counts the tries for that request.

RUN_SUMMARY in the default key-value store has the counts per status, the request count, the HTTP 429 count, the retry count, proxy tier usage and the charged events. It is written even when the input is rejected.

Pricing

Pay per event. No start fee. No charge for a blocked row.

Prices are per event and are charged only for delivered rows.

Event	Price	When
trend-series	$0.002	Each delivered series, region table, related list or daily trends row with status ok or partial
delta-alert	$0.003	Each keyword that has at least one new rising or breakout hit in delta mode

A related list with no new hits in delta mode is still delivered (empty data) and bills trend-series only. It does not bill delta-alert.

Limitations

Google can answer HTTP 429. The actor retries, then blocks that keyword. It does not guess a number.

Related topics are sometimes an empty list. That row is ok with data: [].

The actor reads public charts. It does not browse while logged in, and it does not store cookies, raw HTML or news article URLs.

Values are Google's 0 to 100 index for that keyword alone, not absolute search volume.

FAQ

Why is one keyword blocked while the others succeeded? Google refused that request after the retries. You are not billed for it. The rest of the run still finishes.

What does delta mode store? The rising and breakout queries and topics for that keyword, geo, time range, category and property. The next run compares against that list.

Do I pay if the run finds nothing new? You pay trend-series for each delivered ok or partial row. You pay delta-alert only when at least one new rising or breakout item is in the row.

No warranty

The charts come from a public website that can change or refuse a request. Check anything you rely on. This actor is not affiliated with Google.