{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper & API - Interest, Queries, Trending Now",
"description": "Scrape Google Trends without the official API: interest over time, interest by region and related queries (top and rising) for any keyword, country and time range. Compare up to 5 keywords across Web, YouTube, News, Images and Shopping, plus Trending now searches with news.",
"version": "1.0",
"x-build-id": "sb5qRjt7fT3xeacn3"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/despottt~google-trends-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-despottt-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/despottt~google-trends-scraper/runs": {
"post": {
"operationId": "runs-sync-despottt-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/despottt~google-trends-scraper/run-sync": {
"post": {
"operationId": "run-sync-despottt-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": {
"keywords": {
"title": "🔎 Keywords or topics",
"type": "array",
"description": "One per line, e.g. bitcoin, electric cars. Each keyword returns one result with interest over time, by region and related queries.",
"items": {
"type": "string"
}
},
"geo": {
"title": "Country",
"type": "string",
"description": "Pick a country or Worldwide. You can also type a region code such as US-CA or IT-25.",
"default": ""
},
"timeRange": {
"title": "Time range",
"enum": [
"past_hour",
"past_4h",
"past_day",
"past_7d",
"past_30d",
"past_90d",
"past_12m",
"past_5y",
"all"
],
"type": "string",
"description": "Period of the data. For exact dates use \"From date\" below.",
"default": "past_12m"
},
"dataTypes": {
"title": "Data to collect",
"type": "array",
"description": "Pick only what you need for faster runs. The price per keyword is the same.",
"items": {
"type": "string",
"enum": [
"interestOverTime",
"interestByRegion",
"relatedQueries",
"relatedTopics"
],
"enumTitles": [
"Interest over time",
"Interest by region",
"Related queries",
"Related topics"
]
},
"default": [
"interestOverTime",
"interestByRegion",
"relatedQueries",
"relatedTopics"
]
},
"compareKeywords": {
"title": "Compare keywords on one 0-100 scale",
"type": "boolean",
"description": "On: keywords are compared in groups of up to 5, like in Google Trends. Off: each keyword is analysed alone.",
"default": false
},
"property": {
"title": "Google search type",
"enum": [
"web",
"news",
"youtube",
"images",
"shopping"
],
"type": "string",
"description": "Which Google search to measure.",
"default": "web"
},
"trendingGeos": {
"title": "Trending now: countries",
"type": "array",
"description": "Pick one or more countries. Empty = skip Trending now.",
"items": {
"type": "string",
"enumSuggestedValues": [
"US",
"GB",
"DE",
"FR",
"IT",
"ES",
"CA",
"AU",
"IN",
"BR",
"NL",
"JP",
"AF",
"AL",
"DZ",
"AS",
"AD",
"AO",
"AI",
"AQ",
"AG",
"AR",
"AM",
"AW",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BB",
"BY",
"BE",
"BZ",
"BJ",
"BM",
"BT",
"BO",
"BA",
"BW",
"BV",
"IO",
"BN",
"BG",
"BF",
"BI",
"KH",
"CM",
"CV",
"KY",
"CF",
"TD",
"CL",
"CN",
"CX",
"CC",
"CO",
"KM",
"CG",
"CD",
"CK",
"CR",
"CI",
"HR",
"CU",
"CY",
"CZ",
"DK",
"DJ",
"DM",
"DO",
"EC",
"EG",
"SV",
"GQ",
"ER",
"EE",
"ET",
"FK",
"FO",
"FJ",
"FI",
"GF",
"PF",
"TF",
"GA",
"GM",
"GE",
"GH",
"GI",
"GR",
"GL",
"GD",
"GP",
"GU",
"GT",
"GN",
"GW",
"GY",
"HT",
"HM",
"VA",
"HN",
"HK",
"HU",
"IS",
"ID",
"IR",
"IQ",
"IE",
"IL",
"JM",
"JO",
"KZ",
"KE",
"KI",
"KP",
"KR",
"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",
"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",
"SH",
"KN",
"LC",
"PM",
"VC",
"WS",
"SM",
"ST",
"SA",
"SN",
"RS",
"SC",
"SL",
"SG",
"SK",
"SI",
"SB",
"SO",
"ZA",
"GS",
"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",
"UM",
"UY",
"UZ",
"VU",
"VE",
"VN",
"VG",
"VI",
"WF",
"EH",
"YE",
"ZM",
"ZW"
],
"enumTitles": [
"United States (US)",
"United Kingdom (GB)",
"Germany (DE)",
"France (FR)",
"Italy (IT)",
"Spain (ES)",
"Canada (CA)",
"Australia (AU)",
"India (IN)",
"Brazil (BR)",
"Netherlands (NL)",
"Japan (JP)",
"Afghanistan (AF)",
"Albania (AL)",
"Algeria (DZ)",
"American Samoa (AS)",
"Andorra (AD)",
"Angola (AO)",
"Anguilla (AI)",
"Antarctica (AQ)",
"Antigua and Barbuda (AG)",
"Argentina (AR)",
"Armenia (AM)",
"Aruba (AW)",
"Austria (AT)",
"Azerbaijan (AZ)",
"Bahamas (BS)",
"Bahrain (BH)",
"Bangladesh (BD)",
"Barbados (BB)",
"Belarus (BY)",
"Belgium (BE)",
"Belize (BZ)",
"Benin (BJ)",
"Bermuda (BM)",
"Bhutan (BT)",
"Bolivia (BO)",
"Bosnia and Herzegovina (BA)",
"Botswana (BW)",
"Bouvet Island (BV)",
"British Indian Ocean Territory (IO)",
"Brunei Darussalam (BN)",
"Bulgaria (BG)",
"Burkina Faso (BF)",
"Burundi (BI)",
"Cambodia (KH)",
"Cameroon (CM)",
"Cape Verde (CV)",
"Cayman Islands (KY)",
"Central African Republic (CF)",
"Chad (TD)",
"Chile (CL)",
"China (CN)",
"Christmas Island (CX)",
"Cocos (Keeling) Islands (CC)",
"Colombia (CO)",
"Comoros (KM)",
"Congo (CG)",
"Congo, the Democratic Republic of the (CD)",
"Cook Islands (CK)",
"Costa Rica (CR)",
"Cote D'ivoire (CI)",
"Croatia (HR)",
"Cuba (CU)",
"Cyprus (CY)",
"Czech Republic (CZ)",
"Denmark (DK)",
"Djibouti (DJ)",
"Dominica (DM)",
"Dominican Republic (DO)",
"Ecuador (EC)",
"Egypt (EG)",
"El Salvador (SV)",
"Equatorial Guinea (GQ)",
"Eritrea (ER)",
"Estonia (EE)",
"Ethiopia (ET)",
"Falkland Islands (Malvinas) (FK)",
"Faroe Islands (FO)",
"Fiji (FJ)",
"Finland (FI)",
"French Guiana (GF)",
"French Polynesia (PF)",
"French Southern Territories (TF)",
"Gabon (GA)",
"Gambia (GM)",
"Georgia (GE)",
"Ghana (GH)",
"Gibraltar (GI)",
"Greece (GR)",
"Greenland (GL)",
"Grenada (GD)",
"Guadeloupe (GP)",
"Guam (GU)",
"Guatemala (GT)",
"Guinea (GN)",
"Guinea-Bissau (GW)",
"Guyana (GY)",
"Haiti (HT)",
"Heard Island and Mcdonald Islands (HM)",
"Holy See (Vatican City State) (VA)",
"Honduras (HN)",
"Hong Kong (HK)",
"Hungary (HU)",
"Iceland (IS)",
"Indonesia (ID)",
"Iran, Islamic Republic of (IR)",
"Iraq (IQ)",
"Ireland (IE)",
"Israel (IL)",
"Jamaica (JM)",
"Jordan (JO)",
"Kazakhstan (KZ)",
"Kenya (KE)",
"Kiribati (KI)",
"Korea, Democratic People's Republic of (KP)",
"Korea, Republic of (KR)",
"Kuwait (KW)",
"Kyrgyzstan (KG)",
"Lao People's Democratic Republic (LA)",
"Latvia (LV)",
"Lebanon (LB)",
"Lesotho (LS)",
"Liberia (LR)",
"Libyan Arab Jamahiriya (LY)",
"Liechtenstein (LI)",
"Lithuania (LT)",
"Luxembourg (LU)",
"Macao (MO)",
"Macedonia, the Former Yugoslav Republic of (MK)",
"Madagascar (MG)",
"Malawi (MW)",
"Malaysia (MY)",
"Maldives (MV)",
"Mali (ML)",
"Malta (MT)",
"Marshall Islands (MH)",
"Martinique (MQ)",
"Mauritania (MR)",
"Mauritius (MU)",
"Mayotte (YT)",
"Mexico (MX)",
"Micronesia, Federated States of (FM)",
"Moldova, Republic of (MD)",
"Monaco (MC)",
"Mongolia (MN)",
"Montenegro (ME)",
"Montserrat (MS)",
"Morocco (MA)",
"Mozambique (MZ)",
"Myanmar (MM)",
"Namibia (NA)",
"Nauru (NR)",
"Nepal (NP)",
"New Caledonia (NC)",
"New Zealand (NZ)",
"Nicaragua (NI)",
"Niger (NE)",
"Nigeria (NG)",
"Niue (NU)",
"Norfolk Island (NF)",
"Northern Mariana Islands (MP)",
"Norway (NO)",
"Oman (OM)",
"Pakistan (PK)",
"Palau (PW)",
"Palestinian Territory, Occupied (PS)",
"Panama (PA)",
"Papua New Guinea (PG)",
"Paraguay (PY)",
"Peru (PE)",
"Philippines (PH)",
"Pitcairn (PN)",
"Poland (PL)",
"Portugal (PT)",
"Puerto Rico (PR)",
"Qatar (QA)",
"Reunion (RE)",
"Romania (RO)",
"Russian Federation (RU)",
"Rwanda (RW)",
"Saint Helena (SH)",
"Saint Kitts and Nevis (KN)",
"Saint Lucia (LC)",
"Saint Pierre and Miquelon (PM)",
"Saint Vincent and the Grenadines (VC)",
"Samoa (WS)",
"San Marino (SM)",
"Sao Tome and Principe (ST)",
"Saudi Arabia (SA)",
"Senegal (SN)",
"Serbia (RS)",
"Seychelles (SC)",
"Sierra Leone (SL)",
"Singapore (SG)",
"Slovakia (SK)",
"Slovenia (SI)",
"Solomon Islands (SB)",
"Somalia (SO)",
"South Africa (ZA)",
"South Georgia and the South Sandwich Islands (GS)",
"Sri Lanka (LK)",
"Sudan (SD)",
"Suriname (SR)",
"Svalbard and Jan Mayen (SJ)",
"Swaziland (SZ)",
"Sweden (SE)",
"Switzerland (CH)",
"Syrian Arab Republic (SY)",
"Taiwan, Province of China (TW)",
"Tajikistan (TJ)",
"Tanzania, United Republic of (TZ)",
"Thailand (TH)",
"Timor-Leste (TL)",
"Togo (TG)",
"Tokelau (TK)",
"Tonga (TO)",
"Trinidad and Tobago (TT)",
"Tunisia (TN)",
"Turkey (TR)",
"Turkmenistan (TM)",
"Turks and Caicos Islands (TC)",
"Tuvalu (TV)",
"Uganda (UG)",
"Ukraine (UA)",
"United Arab Emirates (AE)",
"United States Minor Outlying Islands (UM)",
"Uruguay (UY)",
"Uzbekistan (UZ)",
"Vanuatu (VU)",
"Venezuela (VE)",
"Viet Nam (VN)",
"Virgin Islands, British (VG)",
"Virgin Islands, U.S. (VI)",
"Wallis and Futuna (WF)",
"Western Sahara (EH)",
"Yemen (YE)",
"Zambia (ZM)",
"Zimbabwe (ZW)"
]
},
"default": []
},
"trendingHours": {
"title": "Trending now: period",
"enum": [
"4",
"24",
"48",
"168"
],
"type": "string",
"description": "Period of the list.",
"default": "24"
},
"trendingCategory": {
"title": "Trending now: category",
"enum": [
"all",
"Autos and Vehicles",
"Beauty and Fashion",
"Business and Finance",
"Climate",
"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"
],
"type": "string",
"description": "Only trending searches in this category.",
"default": "all"
},
"trendingActiveOnly": {
"title": "Trending now: active trends only",
"type": "boolean",
"description": "Skip trends that have already ended.",
"default": false
},
"trendingMinVolume": {
"title": "Trending now: minimum searches",
"minimum": 0,
"maximum": 100000000,
"type": "integer",
"description": "Skip smaller trends, e.g. 10000.",
"default": 0
},
"maxTrendingPerGeo": {
"title": "Trending now: max per country",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "0 = all (the US list often has 500+).",
"default": 100
},
"includeTrendingNews": {
"title": "Trending now: add news articles",
"type": "boolean",
"description": "Adds the news articles Google links to each trend (title, URL, source, time, image).",
"default": true
},
"newsPerTrend": {
"title": "Trending now: news articles per trend",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "How many articles to add to each trend.",
"default": 3
},
"onlyNew": {
"title": "Trending now: only new trends since the last run",
"type": "boolean",
"description": "For scheduled monitoring: return only trending searches not returned before.",
"default": false
},
"stateKey": {
"title": "Monitor name (optional)",
"type": "string",
"description": "Give each monitor its own name if you run several schedules."
},
"dateFrom": {
"title": "From date (exact range)",
"type": "string",
"description": "Optional. Overrides the time range above. Use together with \"To date\"."
},
"dateTo": {
"title": "To date (exact range)",
"type": "string",
"description": "Empty = today."
},
"category": {
"title": "Category ID",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "0 = all categories. Examples: 7 Finance, 71 Food & Drink, 20 Sports, 958 Mobile Phones. Copy it from the cat= part of a Google Trends URL.",
"default": 0
},
"regionResolution": {
"title": "Interest by region: detail",
"enum": [
"auto",
"COUNTRY",
"REGION",
"CITY",
"DMA"
],
"type": "string",
"description": "Level of detail of interest by region.",
"default": "auto"
},
"startUrls": {
"title": "Google Trends URLs",
"type": "array",
"description": "Optional. Paste Google Trends Explore or Trending now links; their own country, time range and category are used.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Max results",
"minimum": 0,
"maximum": 10000000,
"type": "integer",
"description": "0 = no limit.",
"default": 0
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Used automatically only when Google Trends rate-limits. Leave as is.",
"default": {
"useApifyProxy": true
}
},
"useDirectConnection": {
"title": "Try direct connection first",
"type": "boolean",
"description": "Use the Actor's own IP first and switch to proxy only when rate-limited.",
"default": true
},
"maxConcurrency": {
"title": "Max parallel requests",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Lower it if you see many rate limits.",
"default": 3
}
}
},
"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
}
}
}
}
}
}
}
}
}
}