{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper & API",
"description": "Google Trends API that actually works: interest over time, interest by region, related queries and topics for any keywords or explore URLs, plus trending-now searches. Cookie warm-up, retries, proxy rotation, no browser. Pay per result.",
"version": "1.0",
"x-build-id": "fU6gkJau8krQglz8W"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/symphonic_mullite~google-trends-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-symphonic_mullite-google-trends-scraper",
"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/symphonic_mullite~google-trends-scraper/runs": {
"post": {
"operationId": "runs-sync-symphonic_mullite-google-trends-scraper",
"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/symphonic_mullite~google-trends-scraper/run-sync": {
"post": {
"operationId": "run-sync-symphonic_mullite-google-trends-scraper",
"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": {
"mode": {
"title": "What to scrape",
"enum": [
"keywords",
"trendingNow",
"both"
],
"type": "string",
"description": "Keyword analysis fetches Google Trends data for your search terms / explore URLs. Trending now fetches the current trending searches for the countries in the Trending now section. Both does both in one run."
},
"searchTerms": {
"title": "Search terms",
"type": "array",
"description": "One comparison per line. Put up to 5 comma-separated terms on a line to compare them against each other (values are then relative to the most popular term, exactly like the Trends website). A single term per line gives its own 0-100 scale. You get one result per term. Topic IDs such as /m/0dl9sd also work.",
"items": {
"type": "string"
}
},
"exploreUrls": {
"title": "Google Trends URLs",
"type": "array",
"description": "Optional. Paste links copied from trends.google.com. Explore URLs (https://trends.google.com/trends/explore?q=...) keep their own terms, location, time range, category and search type; trending URLs (https://trends.google.com/trending?geo=DE) add that country to the trending-now scrape.",
"items": {
"type": "string"
}
},
"geo": {
"title": "Location",
"type": "string",
"description": "Country code (US), region (US-CA, GB-SCT), US metro area (US-CA-807), or WORLDWIDE. Pick from the list or type a code. Applies to Search terms (explore URLs keep their own location)."
},
"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",
"custom"
],
"type": "string",
"description": "Period to analyse. Short ranges return minute/hour data points, long ranges weekly or monthly points. Choose Custom range and fill in the dates below for anything else.",
"default": "today 12-m"
},
"startDate": {
"title": "Custom range: start date",
"type": "string",
"description": "Only used when Time range is Custom range. Google Trends data starts on 2004-01-01."
},
"endDate": {
"title": "Custom range: end date",
"type": "string",
"description": "Only used when Time range is Custom range. Leave empty for today."
},
"category": {
"title": "Category",
"type": "string",
"description": "Narrow the data to a category (e.g. Food & Drink for 'java' the island vs. the coffee). Pick a top-level category or type any numeric Google Trends category id (you can copy it from the cat= part of an explore URL).",
"default": "0"
},
"searchProperty": {
"title": "Search type",
"enum": [
"web",
"images",
"news",
"youtube",
"froogle"
],
"type": "string",
"description": "Which Google search property the interest data comes from.",
"default": "web"
},
"includeInterestOverTime": {
"title": "Interest over time",
"type": "boolean",
"description": "Timeline of 0-100 search interest with dates, including the partial (still running) last period.",
"default": true
},
"includeInterestBySubregion": {
"title": "Interest by subregion",
"type": "boolean",
"description": "0-100 interest per country / region / metro / city. For comparisons you also get each term's share per location (geoMapCompared).",
"default": true
},
"subregionResolution": {
"title": "Subregion resolution",
"enum": [
"AUTO",
"COUNTRY",
"REGION",
"DMA",
"CITY"
],
"type": "string",
"description": "Level of detail for interest by subregion. Automatic uses Google's default (countries for worldwide, regions for a country). Metro areas (DMA) exist for the US only. If a level is not available for your location the Actor falls back to the default and says so in notes.",
"default": "AUTO"
},
"includeLowSearchVolumeRegions": {
"title": "Include low search volume regions",
"type": "boolean",
"description": "Also list locations where Google has too little data (value 0, hasData false), like the checkbox on the Trends website.",
"default": false
},
"includeRelatedQueries": {
"title": "Related queries",
"type": "boolean",
"description": "Top and rising searches related to each term (up to 25 each), with links.",
"default": true
},
"includeRelatedTopics": {
"title": "Related topics",
"type": "boolean",
"description": "Top and rising topics related to each term. Google currently returns this list only for some searches; for comparisons it costs one extra explore request per term.",
"default": false
},
"trendingCountries": {
"title": "Trending now: countries",
"type": "array",
"description": "Countries (or regions such as US-CA) to get the current trending searches for, with approximate search volume, related news articles and picture. Used when What to scrape is Trending now or Both.",
"items": {
"type": "string",
"enumSuggestedValues": [
"AD",
"AE",
"AF",
"AG",
"AI",
"AL",
"AM",
"AO",
"AQ",
"AR",
"AS",
"AT",
"AU",
"AW",
"AX",
"AZ",
"BA",
"BB",
"BD",
"BE",
"BF",
"BG",
"BH",
"BI",
"BJ",
"BL",
"BM",
"BN",
"BO",
"BQ",
"BR",
"BS",
"BT",
"BV",
"BW",
"BY",
"BZ",
"CA",
"CC",
"CD",
"CF",
"CG",
"CH",
"CI",
"CK",
"CL",
"CM",
"CN",
"CO",
"CR",
"CU",
"CV",
"CW",
"CX",
"CY",
"CZ",
"DE",
"DJ",
"DK",
"DM",
"DO",
"DZ",
"EC",
"EE",
"EG",
"EH",
"ER",
"ES",
"ET",
"FI",
"FJ",
"FK",
"FM",
"FO",
"FR",
"GA",
"GB",
"GD",
"GE",
"GF",
"GG",
"GH",
"GI",
"GL",
"GM",
"GN",
"GP",
"GQ",
"GR",
"GS",
"GT",
"GU",
"GW",
"GY",
"HK",
"HM",
"HN",
"HR",
"HT",
"HU",
"ID",
"IE",
"IL",
"IM",
"IN",
"IO",
"IQ",
"IR",
"IS",
"IT",
"JE",
"JM",
"JO",
"JP",
"KE",
"KG",
"KH",
"KI",
"KM",
"KN",
"KP",
"KR",
"KW",
"KY",
"KZ",
"LA",
"LB",
"LC",
"LI",
"LK",
"LR",
"LS",
"LT",
"LU",
"LV",
"LY",
"MA",
"MC",
"MD",
"ME",
"MF",
"MG",
"MH",
"MK",
"ML",
"MM",
"MN",
"MO",
"MP",
"MQ",
"MR",
"MS",
"MT",
"MU",
"MV",
"MW",
"MX",
"MY",
"MZ",
"NA",
"NC",
"NE",
"NF",
"NG",
"NI",
"NL",
"NO",
"NP",
"NR",
"NU",
"NZ",
"OM",
"PA",
"PE",
"PF",
"PG",
"PH",
"PK",
"PL",
"PM",
"PN",
"PR",
"PS",
"PT",
"PW",
"PY",
"QA",
"RE",
"RO",
"RS",
"RU",
"RW",
"SA",
"SB",
"SC",
"SD",
"SE",
"SG",
"SH",
"SI",
"SJ",
"SK",
"SL",
"SM",
"SN",
"SO",
"SR",
"SS",
"ST",
"SV",
"SX",
"SY",
"SZ",
"TC",
"TD",
"TF",
"TG",
"TH",
"TJ",
"TK",
"TL",
"TM",
"TN",
"TO",
"TR",
"TT",
"TV",
"TW",
"TZ",
"UA",
"UG",
"UM",
"US",
"UY",
"UZ",
"VA",
"VC",
"VE",
"VG",
"VI",
"VN",
"VU",
"WF",
"WS",
"XK",
"YE",
"YT",
"ZA",
"ZM",
"ZW"
],
"enumTitles": [
"Andorra (AD)",
"United Arab Emirates (AE)",
"Afghanistan (AF)",
"Antigua & Barbuda (AG)",
"Anguilla (AI)",
"Albania (AL)",
"Armenia (AM)",
"Angola (AO)",
"Antarctica (AQ)",
"Argentina (AR)",
"American Samoa (AS)",
"Austria (AT)",
"Australia (AU)",
"Aruba (AW)",
"Åland Islands (AX)",
"Azerbaijan (AZ)",
"Bosnia & Herzegovina (BA)",
"Barbados (BB)",
"Bangladesh (BD)",
"Belgium (BE)",
"Burkina Faso (BF)",
"Bulgaria (BG)",
"Bahrain (BH)",
"Burundi (BI)",
"Benin (BJ)",
"St. Barthélemy (BL)",
"Bermuda (BM)",
"Brunei (BN)",
"Bolivia (BO)",
"Caribbean Netherlands (BQ)",
"Brazil (BR)",
"Bahamas (BS)",
"Bhutan (BT)",
"Bouvet Island (BV)",
"Botswana (BW)",
"Belarus (BY)",
"Belize (BZ)",
"Canada (CA)",
"Cocos (Keeling) Islands (CC)",
"Congo - Kinshasa (CD)",
"Central African Republic (CF)",
"Congo - Brazzaville (CG)",
"Switzerland (CH)",
"Côte d’Ivoire (CI)",
"Cook Islands (CK)",
"Chile (CL)",
"Cameroon (CM)",
"China (CN)",
"Colombia (CO)",
"Costa Rica (CR)",
"Cuba (CU)",
"Cape Verde (CV)",
"Curaçao (CW)",
"Christmas Island (CX)",
"Cyprus (CY)",
"Czechia (CZ)",
"Germany (DE)",
"Djibouti (DJ)",
"Denmark (DK)",
"Dominica (DM)",
"Dominican Republic (DO)",
"Algeria (DZ)",
"Ecuador (EC)",
"Estonia (EE)",
"Egypt (EG)",
"Western Sahara (EH)",
"Eritrea (ER)",
"Spain (ES)",
"Ethiopia (ET)",
"Finland (FI)",
"Fiji (FJ)",
"Falkland Islands (Islas Malvinas) (FK)",
"Micronesia (FM)",
"Faroe Islands (FO)",
"France (FR)",
"Gabon (GA)",
"United Kingdom (GB)",
"Grenada (GD)",
"Georgia (GE)",
"French Guiana (GF)",
"Guernsey (GG)",
"Ghana (GH)",
"Gibraltar (GI)",
"Greenland (GL)",
"Gambia (GM)",
"Guinea (GN)",
"Guadeloupe (GP)",
"Equatorial Guinea (GQ)",
"Greece (GR)",
"South Georgia & South Sandwich Islands (GS)",
"Guatemala (GT)",
"Guam (GU)",
"Guinea-Bissau (GW)",
"Guyana (GY)",
"Hong Kong (HK)",
"Heard & McDonald Islands (HM)",
"Honduras (HN)",
"Croatia (HR)",
"Haiti (HT)",
"Hungary (HU)",
"Indonesia (ID)",
"Ireland (IE)",
"Israel (IL)",
"Isle of Man (IM)",
"India (IN)",
"British Indian Ocean Territory (IO)",
"Iraq (IQ)",
"Iran (IR)",
"Iceland (IS)",
"Italy (IT)",
"Jersey (JE)",
"Jamaica (JM)",
"Jordan (JO)",
"Japan (JP)",
"Kenya (KE)",
"Kyrgyzstan (KG)",
"Cambodia (KH)",
"Kiribati (KI)",
"Comoros (KM)",
"St. Kitts & Nevis (KN)",
"North Korea (KP)",
"South Korea (KR)",
"Kuwait (KW)",
"Cayman Islands (KY)",
"Kazakhstan (KZ)",
"Laos (LA)",
"Lebanon (LB)",
"St. Lucia (LC)",
"Liechtenstein (LI)",
"Sri Lanka (LK)",
"Liberia (LR)",
"Lesotho (LS)",
"Lithuania (LT)",
"Luxembourg (LU)",
"Latvia (LV)",
"Libya (LY)",
"Morocco (MA)",
"Monaco (MC)",
"Moldova (MD)",
"Montenegro (ME)",
"St. Martin (MF)",
"Madagascar (MG)",
"Marshall Islands (MH)",
"North Macedonia (MK)",
"Mali (ML)",
"Myanmar (Burma) (MM)",
"Mongolia (MN)",
"Macao (MO)",
"Northern Mariana Islands (MP)",
"Martinique (MQ)",
"Mauritania (MR)",
"Montserrat (MS)",
"Malta (MT)",
"Mauritius (MU)",
"Maldives (MV)",
"Malawi (MW)",
"Mexico (MX)",
"Malaysia (MY)",
"Mozambique (MZ)",
"Namibia (NA)",
"New Caledonia (NC)",
"Niger (NE)",
"Norfolk Island (NF)",
"Nigeria (NG)",
"Nicaragua (NI)",
"Netherlands (NL)",
"Norway (NO)",
"Nepal (NP)",
"Nauru (NR)",
"Niue (NU)",
"New Zealand (NZ)",
"Oman (OM)",
"Panama (PA)",
"Peru (PE)",
"French Polynesia (PF)",
"Papua New Guinea (PG)",
"Philippines (PH)",
"Pakistan (PK)",
"Poland (PL)",
"St. Pierre & Miquelon (PM)",
"Pitcairn Islands (PN)",
"Puerto Rico (PR)",
"Palestine (PS)",
"Portugal (PT)",
"Palau (PW)",
"Paraguay (PY)",
"Qatar (QA)",
"Réunion (RE)",
"Romania (RO)",
"Serbia (RS)",
"Russia (RU)",
"Rwanda (RW)",
"Saudi Arabia (SA)",
"Solomon Islands (SB)",
"Seychelles (SC)",
"Sudan (SD)",
"Sweden (SE)",
"Singapore (SG)",
"St. Helena (SH)",
"Slovenia (SI)",
"Svalbard & Jan Mayen (SJ)",
"Slovakia (SK)",
"Sierra Leone (SL)",
"San Marino (SM)",
"Senegal (SN)",
"Somalia (SO)",
"Suriname (SR)",
"South Sudan (SS)",
"São Tomé & Príncipe (ST)",
"El Salvador (SV)",
"Sint Maarten (SX)",
"Syria (SY)",
"Eswatini (SZ)",
"Turks & Caicos Islands (TC)",
"Chad (TD)",
"French Southern Territories (TF)",
"Togo (TG)",
"Thailand (TH)",
"Tajikistan (TJ)",
"Tokelau (TK)",
"Timor-Leste (TL)",
"Turkmenistan (TM)",
"Tunisia (TN)",
"Tonga (TO)",
"Türkiye (TR)",
"Trinidad & Tobago (TT)",
"Tuvalu (TV)",
"Taiwan (TW)",
"Tanzania (TZ)",
"Ukraine (UA)",
"Uganda (UG)",
"U.S. Outlying Islands (UM)",
"United States (US)",
"Uruguay (UY)",
"Uzbekistan (UZ)",
"Vatican City (VA)",
"St. Vincent & Grenadines (VC)",
"Venezuela (VE)",
"British Virgin Islands (VG)",
"U.S. Virgin Islands (VI)",
"Vietnam (VN)",
"Vanuatu (VU)",
"Wallis & Futuna (WF)",
"Samoa (WS)",
"Kosovo (XK)",
"Yemen (YE)",
"Mayotte (YT)",
"South Africa (ZA)",
"Zambia (ZM)",
"Zimbabwe (ZW)"
]
}
},
"maxTrendingItemsPerCountry": {
"title": "Max trending searches per country",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "Limit the number of trending searches per country. 0 = everything Google lists (usually 10-20).",
"default": 0
},
"timezone": {
"title": "Time zone",
"type": "string",
"description": "Time zone for minute- and hour-level timeline points (past hour to past 7 days) and for Google's notion of \"today\": an IANA name such as America/New_York or Europe/London, or an offset such as UTC+2. Daily, weekly and monthly points are calendar dates.",
"default": "UTC"
},
"language": {
"title": "Language",
"type": "string",
"description": "Language code (hl) for location names and related queries, e.g. en-US, de, ja.",
"default": "en-US"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify Proxy is used automatically: datacenter IPs first, with a switch to residential IPs if Google keeps rate-limiting (see the next option). You can also pick specific groups or your own proxies.",
"default": {
"useApifyProxy": true
}
},
"residentialFallback": {
"title": "Switch to residential proxies when blocked",
"type": "boolean",
"description": "If Google answers 'Too many requests' to several fresh datacenter IPs in a row, continue the run on Apify residential proxies. No extra cost for you: the price per result stays the same.",
"default": true
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "How many comparisons run in parallel when proxies are used. Higher is faster but more likely to be rate-limited by Google. Direct connections always use 1.",
"default": 3
},
"maxRequestRetries": {
"title": "Max retries per request",
"minimum": 0,
"maximum": 15,
"type": "integer",
"description": "Retries for each request that gets rate-limited or fails, with exponential backoff and a fresh session / IP each time. The run also stops early (instead of looping) if Google blocks 30 requests in a row.",
"default": 6
}
}
},
"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
}
}
}
}
}
}
}
}
}
}