{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper - Interest, Regions & Rising Queries", "description": "Extract Google Trends interest over time, regions, US cities and metros, rising queries with Breakout flags, and Trending now searches by country. Automatic retries, a status row for every term, and you never pay for empty results.", "version": "1.0", "x-build-id": "Q2VKpZab8Do8KtRoe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/snappytools~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-snappytools-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/snappytools~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-snappytools-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/snappytools~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-snappytools-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": [ "explore", "trendingNow" ], "type": "string", "description": "Search terms looks up the words you enter. Trending now lists what people are searching for right now in the countries you pick (no search terms needed).", "default": "explore" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Words or phrases to look up, one per line. You can also paste a Google topic ID such as /m/0k8z. Leave empty if you only use Google Trends URLs below.", "items": { "type": "string" } }, "startUrls": { "title": "Google Trends URLs (optional)", "type": "array", "description": "Paste explore links copied from trends.google.com. Each link keeps its own terms, location, date range, category and search type.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "geo": { "title": "Country (search terms mode)", "enum": [ "", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "DY", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "HV", "BI", "KH", "CM", "CA", "CV", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "ZR", "CK", "CR", "CI", "HR", "CU", "AN", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "FX", "GF", "PF", "TF", "GA", "GM", "GE", "DD", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "BU", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "SU", "RW", "WS", "SM", "ST", "SA", "SN", "CS", "RS", "YU", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TP", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UM", "VI", "UG", "UA", "AE", "GB", "UK", "US", "UY", "UZ", "NH", "VU", "VA", "VE", "VD", "VN", "WF", "EH", "YD", "YE", "ZM", "RH", "ZW" ], "type": "string", "description": "Used when 'What to scrape' is Search terms. Choose a country, or leave as Worldwide. For a state or region, also fill in Region code below.", "default": "" }, "region": { "title": "Region code (optional)", "type": "string", "description": "For a state or region inside the chosen country, e.g. US-CA (California), US-TX (Texas), GB-ENG (England). Overrides Country when filled in.", "default": "" }, "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": "How far back to look. Choose 'Custom' to set exact dates below.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom dates", "type": "string", "description": "Only used when Time range is 'Custom dates'. Format: start date, a space, end date. Example: 2024-01-01 2024-06-30" }, "category": { "title": "Category", "enum": [ "0", "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": "Narrow results to one Google Trends category, e.g. 'apple' in Food & Drink vs Computers & Electronics.", "default": "0" }, "searchProperty": { "title": "Search type", "enum": [ "", "images", "news", "froogle", "youtube" ], "type": "string", "description": "Which Google search to measure.", "default": "" }, "trendingCountries": { "title": "Countries (Trending now mode)", "type": "array", "description": "Used when 'What to scrape' is Trending now. Pick one or more countries; each gives about 10 trending searches. Leave empty to use the country above (or the United States).", "items": { "type": "string", "enum": [ "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "DY", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "HV", "BI", "KH", "CM", "CA", "CV", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "ZR", "CK", "CR", "CI", "HR", "CU", "AN", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "FX", "GF", "PF", "TF", "GA", "GM", "GE", "DD", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "BU", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "SU", "RW", "WS", "SM", "ST", "SA", "SN", "CS", "RS", "YU", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TP", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UM", "VI", "UG", "UA", "AE", "GB", "UK", "US", "UY", "UZ", "NH", "VU", "VA", "VE", "VD", "VN", "WF", "EH", "YD", "YE", "ZM", "RH", "ZW" ], "enumTitles": [ "Afghanistan (AF)", "Åland Islands (AX)", "Albania (AL)", "Algeria (DZ)", "American Samoa (AS)", "Andorra (AD)", "Angola (AO)", "Anguilla (AI)", "Antarctica (AQ)", "Antigua & Barbuda (AG)", "Argentina (AR)", "Armenia (AM)", "Aruba (AW)", "Australia (AU)", "Austria (AT)", "Azerbaijan (AZ)", "Bahamas (BS)", "Bahrain (BH)", "Bangladesh (BD)", "Barbados (BB)", "Belarus (BY)", "Belgium (BE)", "Belize (BZ)", "Benin (BJ)", "Benin (DY)", "Bermuda (BM)", "Bhutan (BT)", "Bolivia (BO)", "Bosnia & Herzegovina (BA)", "Botswana (BW)", "Bouvet Island (BV)", "Brazil (BR)", "British Indian Ocean Territory (IO)", "British Virgin Islands (VG)", "Brunei (BN)", "Bulgaria (BG)", "Burkina Faso (BF)", "Burkina Faso (HV)", "Burundi (BI)", "Cambodia (KH)", "Cameroon (CM)", "Canada (CA)", "Cape Verde (CV)", "Caribbean Netherlands (BQ)", "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 - Brazzaville (CG)", "Congo - Kinshasa (CD)", "Congo - Kinshasa (ZR)", "Cook Islands (CK)", "Costa Rica (CR)", "Côte d’Ivoire (CI)", "Croatia (HR)", "Cuba (CU)", "Curaçao (AN)", "Curaçao (CW)", "Cyprus (CY)", "Czechia (CZ)", "Denmark (DK)", "Djibouti (DJ)", "Dominica (DM)", "Dominican Republic (DO)", "Ecuador (EC)", "Egypt (EG)", "El Salvador (SV)", "Equatorial Guinea (GQ)", "Eritrea (ER)", "Estonia (EE)", "Eswatini (SZ)", "Ethiopia (ET)", "Falkland Islands (FK)", "Faroe Islands (FO)", "Fiji (FJ)", "Finland (FI)", "France (FR)", "France (FX)", "French Guiana (GF)", "French Polynesia (PF)", "French Southern Territories (TF)", "Gabon (GA)", "Gambia (GM)", "Georgia (GE)", "Germany (DD)", "Germany (DE)", "Ghana (GH)", "Gibraltar (GI)", "Greece (GR)", "Greenland (GL)", "Grenada (GD)", "Guadeloupe (GP)", "Guam (GU)", "Guatemala (GT)", "Guernsey (GG)", "Guinea (GN)", "Guinea-Bissau (GW)", "Guyana (GY)", "Haiti (HT)", "Heard & McDonald Islands (HM)", "Honduras (HN)", "Hong Kong SAR China (HK)", "Hungary (HU)", "Iceland (IS)", "India (IN)", "Indonesia (ID)", "Iran (IR)", "Iraq (IQ)", "Ireland (IE)", "Isle of Man (IM)", "Israel (IL)", "Italy (IT)", "Jamaica (JM)", "Japan (JP)", "Jersey (JE)", "Jordan (JO)", "Kazakhstan (KZ)", "Kenya (KE)", "Kiribati (KI)", "Kuwait (KW)", "Kyrgyzstan (KG)", "Laos (LA)", "Latvia (LV)", "Lebanon (LB)", "Lesotho (LS)", "Liberia (LR)", "Libya (LY)", "Liechtenstein (LI)", "Lithuania (LT)", "Luxembourg (LU)", "Macao SAR China (MO)", "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 (FM)", "Moldova (MD)", "Monaco (MC)", "Mongolia (MN)", "Montenegro (ME)", "Montserrat (MS)", "Morocco (MA)", "Mozambique (MZ)", "Myanmar (Burma) (BU)", "Myanmar (Burma) (MM)", "Namibia (NA)", "Nauru (NR)", "Nepal (NP)", "Netherlands (NL)", "New Caledonia (NC)", "New Zealand (NZ)", "Nicaragua (NI)", "Niger (NE)", "Nigeria (NG)", "Niue (NU)", "Norfolk Island (NF)", "North Korea (KP)", "North Macedonia (MK)", "Northern Mariana Islands (MP)", "Norway (NO)", "Oman (OM)", "Pakistan (PK)", "Palau (PW)", "Palestinian Territories (PS)", "Panama (PA)", "Papua New Guinea (PG)", "Paraguay (PY)", "Peru (PE)", "Philippines (PH)", "Pitcairn Islands (PN)", "Poland (PL)", "Portugal (PT)", "Puerto Rico (PR)", "Qatar (QA)", "Réunion (RE)", "Romania (RO)", "Russia (RU)", "Russia (SU)", "Rwanda (RW)", "Samoa (WS)", "San Marino (SM)", "São Tomé & Príncipe (ST)", "Saudi Arabia (SA)", "Senegal (SN)", "Serbia (CS)", "Serbia (RS)", "Serbia (YU)", "Seychelles (SC)", "Sierra Leone (SL)", "Singapore (SG)", "Sint Maarten (SX)", "Slovakia (SK)", "Slovenia (SI)", "Solomon Islands (SB)", "Somalia (SO)", "South Africa (ZA)", "South Georgia & South Sandwich Islands (GS)", "South Korea (KR)", "South Sudan (SS)", "Spain (ES)", "Sri Lanka (LK)", "St. Barthélemy (BL)", "St. Helena (SH)", "St. Kitts & Nevis (KN)", "St. Lucia (LC)", "St. Martin (MF)", "St. Pierre & Miquelon (PM)", "St. Vincent & Grenadines (VC)", "Sudan (SD)", "Suriname (SR)", "Svalbard & Jan Mayen (SJ)", "Sweden (SE)", "Switzerland (CH)", "Syria (SY)", "Taiwan (TW)", "Tajikistan (TJ)", "Tanzania (TZ)", "Thailand (TH)", "Timor-Leste (TL)", "Timor-Leste (TP)", "Togo (TG)", "Tokelau (TK)", "Tonga (TO)", "Trinidad & Tobago (TT)", "Tunisia (TN)", "Türkiye (TR)", "Turkmenistan (TM)", "Turks & Caicos Islands (TC)", "Tuvalu (TV)", "U.S. Outlying Islands (UM)", "U.S. Virgin Islands (VI)", "Uganda (UG)", "Ukraine (UA)", "United Arab Emirates (AE)", "United Kingdom (GB)", "United Kingdom (UK)", "United States (US)", "Uruguay (UY)", "Uzbekistan (UZ)", "Vanuatu (NH)", "Vanuatu (VU)", "Vatican City (VA)", "Venezuela (VE)", "Vietnam (VD)", "Vietnam (VN)", "Wallis & Futuna (WF)", "Western Sahara (EH)", "Yemen (YD)", "Yemen (YE)", "Zambia (ZM)", "Zimbabwe (RH)", "Zimbabwe (ZW)" ] }, "default": [] }, "maxTrendingItems": { "title": "Max trending searches per country", "minimum": 1, "maximum": 25, "type": "integer", "description": "Google's feed lists about 10 trending searches per country, in Google's order (most recent first). Lower this to cap cost.", "default": 10 }, "includeNewsArticles": { "title": "Include news articles", "type": "boolean", "description": "Adds the news stories Google links to each trending search (title, source, URL, image). No extra charge.", "default": true }, "compareMode": { "title": "Compare terms against each other", "type": "boolean", "description": "On: terms are compared in groups of up to 5, so values are relative to each other, exactly like the comparison view on Google Trends. Off: each term is measured on its own 0-100 scale.", "default": false }, "includeInterestOverTime": { "title": "Interest over time", "type": "boolean", "description": "The 0-100 popularity line across your time range.", "default": true }, "includeRegions": { "title": "Interest by state or region (or by country when worldwide)", "type": "boolean", "description": "Popularity by state/region (or by country for worldwide searches).", "default": true }, "includeCities": { "title": "Interest by city (US and some countries only)", "type": "boolean", "description": "Off by default. Google Trends now offers city data mainly for the US and a few other countries. Includes latitude and longitude. When Google has no city data for your search, the status row says so and nothing is charged.", "default": false }, "includeMetros": { "title": "Interest by US metro area (DMA)", "type": "boolean", "description": "Only works when the location is the US or a US state.", "default": false }, "includeRelatedQueries": { "title": "Related queries (top and rising)", "type": "boolean", "description": "Top and rising related search queries, with Breakout flags.", "default": true }, "includeSummary": { "title": "Insights summary", "type": "boolean", "description": "Adds one plain-English row per term: peak, latest versus average, overall direction, fastest-rising search and strongest region.", "default": true }, "maxRelatedItems": { "title": "Max related items per list", "minimum": 1, "maximum": 50, "type": "integer", "description": "Up to 50 top and 50 rising queries per term, when Google has that many. Lower it to save cost.", "default": 50 }, "includeZeroValues": { "title": "Include places and dates with no data", "type": "boolean", "description": "Off by default so your results are not padded with zero rows.", "default": false }, "recheckEmptySections": { "title": "Re-check empty sections", "type": "boolean", "description": "If a section comes back empty or fails, try it once more on a fresh connection before reporting it.", "default": true }, "maxRetries": { "title": "Max retries per request", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many times to retry a blocked or failed request on a fresh IP before giving up on that section.", "default": 6 }, "delayBetweenRequestsMs": { "title": "Delay between requests (milliseconds)", "minimum": 0, "type": "integer", "description": "A short pause keeps Google from throttling the run.", "default": 1000 }, "language": { "title": "Language", "type": "string", "description": "Language for place and topic names, e.g. en-US, en-GB, de, fr.", "default": "en-US" }, "timezone": { "title": "Time zone", "type": "string", "description": "Time zone for dates, e.g. UTC, America/New_York, Europe/London.", "default": "UTC" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxies give the most reliable results with Google.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }