{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper & API + Trending Now",
"description": "Google Trends scraper and pytrends alternative: interest over time, by region, state and city, related queries (top + rising), compare up to 5 keywords, and Trending now for any country. No browser, 256 MB. 97.5% of queries complete in a 160-query test; failed queries are never charged.",
"version": "1.0",
"x-build-id": "QJEWPfHiuvjAVbKn7"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/mitp1997~google-trends-scraper-reliable/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-mitp1997-google-trends-scraper-reliable",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/mitp1997~google-trends-scraper-reliable/runs": {
"post": {
"operationId": "runs-sync-mitp1997-google-trends-scraper-reliable",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/mitp1997~google-trends-scraper-reliable/run-sync": {
"post": {
"operationId": "run-sync-mitp1997-google-trends-scraper-reliable",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"searchTerms": {
"title": "Search terms",
"type": "array",
"description": "One query per line. To compare up to 5 terms against each other (like the Trends 'Compare' button), put them on one line separated by commas, e.g. tea, coffee. Topic IDs such as /m/0d6lp also work.",
"items": {
"type": "string"
}
},
"compareAllTerms": {
"title": "Compare all terms together",
"type": "boolean",
"description": "Put every term from the list into one comparison (Google allows max 5 per comparison; more terms are split into groups of 5).",
"default": false
},
"startUrls": {
"title": "Google Trends URLs",
"type": "array",
"description": "Optional. Paste trends.google.com/trends/explore URLs; the q, geo, date, cat and gprop parameters are used as-is.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"geo": {
"title": "Location",
"enum": [
"",
"AF",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AI",
"AQ",
"AG",
"AR",
"AM",
"AW",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BM",
"BT",
"BO",
"BQ",
"BA",
"BW",
"BV",
"BR",
"IO",
"BN",
"BG",
"BF",
"BI",
"CV",
"KH",
"CM",
"CA",
"KY",
"CF",
"TD",
"CL",
"CN",
"CX",
"Keeling Islands ",
"CO",
"KM",
"CG",
"CD",
"CK",
"CR",
"CI",
"HR",
"CU",
"CW",
"CY",
"CZ",
"DK",
"DJ",
"DM",
"DO",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"ET",
"Malvinas ",
"FO",
"FJ",
"FI",
"FR",
"GF",
"PF",
"TF",
"GA",
"GM",
"GE",
"DE",
"GH",
"GI",
"GR",
"GL",
"GD",
"GP",
"GU",
"GT",
"GG",
"GN",
"GW",
"GY",
"HT",
"HM",
"Vatican City State ",
"HN",
"HK",
"HU",
"IS",
"IN",
"ID",
"IR",
"IQ",
"IE",
"IM",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KI",
"the Democratic People's Republic of ",
"the Republic of ",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MO",
"MK",
"MG",
"MW",
"MY",
"MV",
"ML",
"MT",
"MH",
"MQ",
"MR",
"MU",
"YT",
"MX",
"FM",
"MD",
"MC",
"MN",
"ME",
"MS",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NL",
"NC",
"NZ",
"NI",
"NE",
"NG",
"NU",
"NF",
"MP",
"NO",
"OM",
"PK",
"PW",
"PS",
"PA",
"PG",
"PY",
"PE",
"PH",
"PN",
"PL",
"PT",
"PR",
"QA",
"RE",
"RO",
"RU",
"RW",
"BL",
"SH",
"KN",
"LC",
"French part ",
"PM",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SL",
"SG",
"Dutch part ",
"SK",
"SI",
"SB",
"SO",
"ZA",
"GS",
"SS",
"ES",
"LK",
"SD",
"SR",
"SJ",
"SZ",
"SE",
"CH",
"SY",
"TW",
"TJ",
"TZ",
"TH",
"TL",
"TG",
"TK",
"TO",
"TT",
"TN",
"TR",
"TM",
"TC",
"TV",
"UG",
"UA",
"AE",
"GB",
"US",
"UM",
"UY",
"UZ",
"VU",
"VE",
"VN",
"VG",
"VI",
"WF",
"EH",
"YE",
"ZM",
"ZW"
],
"type": "string",
"description": "Country to get data for. Leave 'Worldwide' for global data.",
"default": ""
},
"geos": {
"title": "More locations (codes)",
"type": "array",
"description": "Optional extra location codes; every query is run for every location. Supports sub-regions, e.g. IN, US, IN-MH (Maharashtra), US-CA, US-NY-501 (metro).",
"items": {
"type": "string"
}
},
"timeRange": {
"title": "Time range",
"enum": [
"now 1-H",
"now 4-H",
"now 1-d",
"now 7-d",
"today 1-m",
"today 3-m",
"today 12-m",
"today 5-y",
"all"
],
"type": "string",
"description": "Preset time range. Hourly presets return minute/hour resolution; 5 years and 2004-present return monthly/weekly data.",
"default": "today 12-m"
},
"customTimeRange": {
"title": "Custom time range",
"pattern": "^\\s*(\\d{4}-\\d{2}-\\d{2}(T\\d{2})?\\s+\\d{4}-\\d{2}-\\d{2}(T\\d{2})?)?\\s*$",
"type": "string",
"description": "Overrides Time range. Format YYYY-MM-DD YYYY-MM-DD, e.g. 2024-01-01 2024-12-31. For hourly data within the last 7 days use YYYY-MM-DDTHH YYYY-MM-DDTHH."
},
"category": {
"title": "Category",
"enum": [
"",
"3",
"47",
"44",
"22",
"12",
"5",
"7",
"71",
"8",
"45",
"65",
"11",
"13",
"958",
"19",
"16",
"299",
"14",
"66",
"29",
"533",
"174",
"18",
"20",
"67"
],
"type": "string",
"description": "Restrict interest to a Google Trends category.",
"default": ""
},
"searchProperty": {
"title": "Search type",
"enum": [
"",
"images",
"news",
"youtube",
"froogle"
],
"type": "string",
"description": "Which Google property the interest comes from (same as the Trends 'Web search' dropdown).",
"default": ""
},
"includeInterestOverTime": {
"title": "Interest over time",
"type": "boolean",
"description": "Timeline of interest (0-100) for each term.",
"default": true
},
"includeInterestByRegion": {
"title": "Interest by region",
"type": "boolean",
"description": "Countries (Worldwide), states/subregions (country), or metros/cities depending on Region resolution.",
"default": true
},
"regionResolution": {
"title": "Region resolution",
"enum": [
"AUTO",
"COUNTRY",
"REGION",
"DMA",
"CITY"
],
"type": "string",
"description": "Granularity for 'Interest by region'.",
"default": "AUTO"
},
"includeInterestByCity": {
"title": "Also add interest by city",
"type": "boolean",
"description": "Adds a separate interestByCity list (requires a location).",
"default": false
},
"includeLowSearchVolumeGeos": {
"title": "Include low search volume regions",
"type": "boolean",
"description": "Also return regions with low search volume (same as the checkbox on the Trends website).",
"default": false
},
"includeRelatedQueries": {
"title": "Related queries (top + rising)",
"type": "boolean",
"description": "Top and rising related search queries for each term.",
"default": true
},
"includeRelatedTopics": {
"title": "Related topics (top + rising)",
"type": "boolean",
"description": "Note: Google only provides related topics for single-term queries, not for comparisons.",
"default": true
},
"maxRelatedItems": {
"title": "Max related queries/topics per list",
"minimum": 0,
"type": "integer",
"description": "0 = everything Google returns (usually up to 25).",
"default": 0
},
"includeTrendingNow": {
"title": "Scrape 'Trending now'",
"type": "boolean",
"description": "Also scrape currently trending searches (trends.google.com/trending) for a country. Each trending topic is one result.",
"default": false
},
"trendingGeo": {
"title": "Trending now: country",
"enum": [
"AF",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AI",
"AQ",
"AG",
"AR",
"AM",
"AW",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BM",
"BT",
"BO",
"BQ",
"BA",
"BW",
"BV",
"BR",
"IO",
"BN",
"BG",
"BF",
"BI",
"CV",
"KH",
"CM",
"CA",
"KY",
"CF",
"TD",
"CL",
"CN",
"CX",
"Keeling Islands ",
"CO",
"KM",
"CG",
"CD",
"CK",
"CR",
"CI",
"HR",
"CU",
"CW",
"CY",
"CZ",
"DK",
"DJ",
"DM",
"DO",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"ET",
"Malvinas ",
"FO",
"FJ",
"FI",
"FR",
"GF",
"PF",
"TF",
"GA",
"GM",
"GE",
"DE",
"GH",
"GI",
"GR",
"GL",
"GD",
"GP",
"GU",
"GT",
"GG",
"GN",
"GW",
"GY",
"HT",
"HM",
"Vatican City State ",
"HN",
"HK",
"HU",
"IS",
"IN",
"ID",
"IR",
"IQ",
"IE",
"IM",
"IL",
"IT",
"JM",
"JP",
"JE",
"JO",
"KZ",
"KE",
"KI",
"the Democratic People's Republic of ",
"the Republic of ",
"KW",
"KG",
"LA",
"LV",
"LB",
"LS",
"LR",
"LY",
"LI",
"LT",
"LU",
"MO",
"MK",
"MG",
"MW",
"MY",
"MV",
"ML",
"MT",
"MH",
"MQ",
"MR",
"MU",
"YT",
"MX",
"FM",
"MD",
"MC",
"MN",
"ME",
"MS",
"MA",
"MZ",
"MM",
"NA",
"NR",
"NP",
"NL",
"NC",
"NZ",
"NI",
"NE",
"NG",
"NU",
"NF",
"MP",
"NO",
"OM",
"PK",
"PW",
"PS",
"PA",
"PG",
"PY",
"PE",
"PH",
"PN",
"PL",
"PT",
"PR",
"QA",
"RE",
"RO",
"RU",
"RW",
"BL",
"SH",
"KN",
"LC",
"French part ",
"PM",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SL",
"SG",
"Dutch part ",
"SK",
"SI",
"SB",
"SO",
"ZA",
"GS",
"SS",
"ES",
"LK",
"SD",
"SR",
"SJ",
"SZ",
"SE",
"CH",
"SY",
"TW",
"TJ",
"TZ",
"TH",
"TL",
"TG",
"TK",
"TO",
"TT",
"TN",
"TR",
"TM",
"TC",
"TV",
"UG",
"UA",
"AE",
"GB",
"US",
"UM",
"UY",
"UZ",
"VU",
"VE",
"VN",
"VG",
"VI",
"WF",
"EH",
"YE",
"ZM",
"ZW"
],
"type": "string",
"description": "Country for Trending now.",
"default": "US"
},
"trendingHours": {
"title": "Trending now: period",
"enum": [
"4",
"24",
"48",
"168"
],
"type": "string",
"description": "How far back Trending now looks.",
"default": "24"
},
"trendingCategories": {
"title": "Trending now: categories",
"type": "array",
"description": "Empty = all categories.",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20"
],
"enumTitles": [
"Autos and Vehicles",
"Beauty and Fashion",
"Business and Finance",
"Entertainment",
"Food and Drink",
"Games",
"Health",
"Hobbies and Leisure",
"Jobs and Education",
"Law and Government",
"Other",
"Pets and Animals",
"Politics",
"Science",
"Shopping",
"Sports",
"Technology",
"Travel and Transportation",
"Climate"
]
},
"default": []
},
"trendingActiveOnly": {
"title": "Trending now: active trends only",
"type": "boolean",
"description": "Only return trends that Google still marks as active.",
"default": false
},
"trendingIncludeNews": {
"title": "Trending now: attach news articles",
"type": "boolean",
"description": "Adds news articles from Google's trending RSS feed where available (usually only the top ~10-20 topics).",
"default": false
},
"trendingMaxItems": {
"title": "Trending now: max topics",
"minimum": 0,
"type": "integer",
"description": "0 = all (can be 1,000+ for 48 h / 7 days).",
"default": 100
},
"language": {
"title": "Language (hl)",
"type": "string",
"description": "Language for topic names and labels, e.g. en-US, hi, de.",
"default": "en-US"
},
"timezoneOffset": {
"title": "Timezone offset (minutes)",
"type": "integer",
"description": "Same as Google's tz parameter: minutes WEST of UTC. 0 = UTC, -330 = India (IST), 300 = US Eastern (EST).",
"default": 0
},
"maxItems": {
"title": "Max results",
"minimum": 0,
"type": "integer",
"description": "Stop after this many keyword results. 0 = no limit.",
"default": 0
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Google rate-limits aggressively. RESIDENTIAL (default) worked best in our tests; Apify datacenter proxies were blocked within the first minute. If you choose another group, the Actor falls back to RESIDENTIAL automatically when blocked.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
},
"fallbackToResidentialProxy": {
"title": "Fall back to residential proxy when blocked",
"type": "boolean",
"description": "If the selected proxy keeps getting HTTP 429 from Google, new sessions switch to Apify RESIDENTIAL proxy automatically (if your plan has it).",
"default": true
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Parallel queries. Higher is faster but triggers Google rate limits sooner.",
"default": 3
},
"maxRequestRetries": {
"title": "Max retries per request",
"minimum": 0,
"maximum": 15,
"type": "integer",
"description": "Retries per HTTP request (with exponential backoff and session/IP rotation on HTTP 429). Each query is additionally retried up to 3 times as a whole.",
"default": 6
},
"requestTimeoutSecs": {
"title": "Request timeout (seconds)",
"minimum": 5,
"maximum": 120,
"type": "integer",
"description": "Timeout for a single HTTP request to Google.",
"default": 30
},
"queryTimeoutSecs": {
"title": "Time limit per query (seconds)",
"minimum": 30,
"maximum": 900,
"type": "integer",
"description": "Upper bound for one query including all retries. When it is reached the query is saved as an error record (not charged) and the run moves on.",
"default": 180
},
"failIfAllQueriesFail": {
"title": "Mark run as failed if every query fails",
"type": "boolean",
"description": "If every query fails (e.g. Google blocks all IPs), finish the run as FAILED so your integrations notice. Otherwise the run succeeds with error records.",
"default": true
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}