Batch Google Trends data with a transparent success rate: interest-over-time and related queries per search term, with geo, timeframe and language control. Strict output schema for AI agents and pipelines; only successfully delivered terms are charged.
One search term with full interest-over-time series and related queries. Failed terms are never charged.
ACTOR=steadydata~google-trends-batch 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 '{"queries": ["chatgpt"], "timeframe": "today 12-m", "includeRelatedQueries": true}'
import os, requests ACTOR = "steadydata~google-trends-batch" 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={'queries': ['chatgpt'], 'timeframe': 'today 12-m', 'includeRelatedQueries': True}, 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-batch"; 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({"queries": ["chatgpt"], "timeframe": "today 12-m", "includeRelatedQueries": true}), }).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-batch # the tool arrives in your agent as steadydata--google-trends-batch
| Field | Type | Name | What it does |
|---|---|---|---|
queriesrequired | array of string | Search terms | Search terms to fetch trends for. Max 200 per run. |
geo | string | Region | Geo code such as US, NL, DE, or empty for worldwide. Region codes like US-CA also work. |
timeframe | string | Timeframe | Trends timeframe: 'now 1-d', 'now 7-d', 'today 1-m', 'today 3-m', 'today 12-m', 'today 5-y', or 'all'. |
includeRelatedQueries | boolean | Include related queries | Adds top and rising related queries per term. |
language | string | Interface language | hl parameter, e.g. en-US or nl-NL. Affects formatted labels only. |
{
"query": string,
"status": string,
"geo": string,
"timeframe": string,
"averageValue": number,
"interestOverTime": array,
"relatedQueries": object | null,
"relatedQueriesNote": string,
"errorCode": string,
"error": string,
"input": string
}| Field | Type | When it is filled |
|---|---|---|
query | string | |
status | string | Either 'ok' or 'error'. An error row carries errorCode and error, and leaves the data fields empty; it is never charged. |
geo | string | |
timeframe | string | |
averageValue | number | |
interestOverTime | array | |
relatedQueries | object, null | |
relatedQueriesNote | string | |
errorCode | string | Filled on an error row only; a delivered row leaves it empty. |
error | string | Filled on an error row only; a delivered row leaves it empty. |
input | string | The input this row was built from, so a row can always be traced back. |
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.