Compare up to 5 keywords in Google Trends, the way the Compare view does: relative interest over time for all terms on one scale, the average per term, the leader, and optionally which term wins in each country or region. Up to 200 comparisons per run. Pay per comparison.
One comparison of up to 5 keywords delivered with its full time series. Comparisons without data are never charged.
ACTOR=steadydata~google-trends-compare URL="https://api.apify.com/v2/acts/$ACTOR/run-sync-get-dataset-items" curl -X POST "$URL?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"comparisons": ["bitcoin, ethereum, solana", "iphone, samsung galaxy, pixel"], "timeframe": "today 12-m", "includeRegions": false}'
import os, requests ACTOR = "steadydata~google-trends-compare" URL = f"https://api.apify.com/v2/acts/{ACTOR}/run-sync-get-dataset-items" rows = requests.post( URL, params={"token": os.environ["APIFY_TOKEN"]}, json={'comparisons': ['bitcoin, ethereum, solana', 'iphone, samsung galaxy, pixel'], 'timeframe': 'today 12-m', 'includeRegions': False}, timeout=900, ).json() # every row carries a status; failures are records, not exceptions ok = [r for r in rows if r.get("status") == "ok"] print(len(ok), "rows delivered")
const ACTOR = "steadydata~google-trends-compare"; const url = `https://api.apify.com/v2/acts/${ACTOR}/run-sync-get-dataset-items` + `?token=${process.env.APIFY_TOKEN}`; const rows = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({"comparisons": ["bitcoin, ethereum, solana", "iphone, samsung galaxy, pixel"], "timeframe": "today 12-m", "includeRegions": false}), }).then((r) => r.json()); // one object per delivered row, same shape every time console.log(rows.filter((r) => r.status === "ok").length, "rows");
Point an MCP client at Apify's hosted server with this dataset in the tools list, or run our own server locally. The field explanations in the table below travel with the schema, so your agent reads them straight from the platform instead of from this page.
https://mcp.apify.com?tools=steadydata/google-trends-compare # the tool arrives in your agent as steadydata--google-trends-compare
| Field | Type | Name | What it does |
|---|---|---|---|
comparisonsrequired | array of string | Comparisons | One comparison per row: 2 to 5 keywords separated by commas, e.g. 'bitcoin, ethereum, solana'. Each row is one input and one charged event; a row without data comes back as a free error record. |
geo | string | Country (empty = worldwide) | Leave empty for worldwide, or a two-letter country code (US, GB, NL, DE ...). |
timeframe | string | Timeframe | The period the interest is measured over. |
includeRegions | boolean | Include per-region winners | Also fetch the breakdown by country (worldwide) or region (within a country) with the share of each term, so you see which term wins where. One extra request per comparison. |
language | string | Language | Interface language (hl), e.g. en-US, nl, de. |
{
"terms": array | null,
"geo": string | null,
"timeframe": string | null,
"averages": array | null,
"leader": string | null,
"leaderShare": number | null,
"pointCount": integer | null,
"series": array | null,
"regions": array | null,
"status": string | null,
"input": string | null,
"errorCode": string | null,
"error": string | null
}| Field | Type | When it is filled |
|---|---|---|
terms | array, null | |
geo | string, null | |
timeframe | string, null | |
averages | array, null | Filled when Google returns a series for the comparison. |
leader | string, null | Filled when at least one term returns interest above zero over the period. |
leaderShare | number, null | Filled when at least one term returns interest above zero over the period. |
pointCount | integer, null | Counted from series; empty when Google returns no series. |
series | array, null | Filled when Google returns a series for the comparison. |
regions | array, null | Filled when includeRegions is on; empty otherwise. |
status | string, null | Either 'ok' or 'error'. An error row carries errorCode and error, and leaves the data fields empty; it is never charged. |
input | string, null | The input this row was built from, so a row can always be traced back. |
errorCode | string, null | Filled on an error row only; a delivered row leaves it empty. |
error | string, null | Filled on an error row only; a delivered row leaves it empty. |
Ads from Google's Ads Transparency Center per advertiser domain or advertiser id, per country or worldwide: creative id, advertiser name, preview image or preview URL, first and last shown dates and a link to the ad. Up to 200 advertisers per run. Pay only for delivered ads.
$1.40 per 1,000 · Ad listedGoogle's autocomplete suggestions for up to 500 seed keywords per run, per country and language, with optional a-to-z and question-word expansion for hundreds of long-tail keywords per seed. Ranked, with Google's relevance score and suggestion type. Pay only for delivered suggestions.
$0.35 per 1,000 · Suggestion listedFlight options from Google Flights for up to 200 searches per run: price, airlines, flight numbers, departure and arrival times, duration, stops and layover airports, aircraft and CO2 estimate, in Google's order. One-way or round trip, any cabin class and currency. Pay only for delivered flights.
$1.40 per 1,000 · Flight listedAlready using this one? Ratings are the first thing other buyers look at, and this dataset has none yet. If it does a job for you, a rating on its Apify page is the one thing that helps. It takes a minute and it is the only thing we ask for.