{"uid":"cap_2bA0St67tGlV3hhIQuVH6","slug":"google-trends-scraper-via-stableapify-d457adb1","name":"Google Trends Scraper via StableApify","description":"Start the \"Google Trends Scraper\" Apify actor (apify/google-trends-scraper). Scrape data from Google Trends by search terms or URLs. Specify locations, define time ranges, select categories to get interest by subregion and over time, re…","url":"https://stableapify.dev/api/actors/apify/google-trends-scraper/call","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","required":["isMultiple","timeRange","geo","skipDebugScreen","category","maxItems","maxConcurrency","maxRequestRetries","pageLoadTimeoutSecs"],"properties":{"geo":{"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","default":"","description":"Get results from a specific geo area (defaults to 'Worldwide'). This maps to different fields in the dataset results: smaller countries like Greece return just 'interestByCity' data, while larger ones like the United States return 'interestBySubregion' data as well. When omitted (Worldwide), 'interestBy' is returned instead, which corresponds to the 'Interest by area' section on Google Trends. Note: When using Google Trends URLs from the '🔗 Use a Google Trends URL instead of search terms' section, the geo parameter from the URL's query string takes precedence over this setting. You can also use start URLs to retrieve 'interestByMetro' data for metropolitan areas by providing URLs with more specific geo regions like California (US) directly copied from Google Trends."},"category":{"enum":["3","5","7","8","11","12","13","14","16","18","19","20","22","29","44","45","47","65","66","67","71","174","299","533","958",""],"type":"string","default":"","description":"Choose a category to filter the search for (defaults to 'All categories')"},"maxItems":{"type":"integer","default":0,"maximum":9007199254740991,"minimum":0,"description":"Limit of product items to be scraped. Zero value means no limit."},"startUrls":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"method":{"type":"string"},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"payload":{"type":"string"},"userData":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false},"description":"Copy a Google Trends URL and paste it here."},"timeRange":{"enum":["","now 1-H","now 4-H","now 1-d","now 7-d","today 1-m","today 3-m","today 5-y","all"],"type":"string","default":"","description":"Choose a predefined search's time range (defaults to 'Past 12 months')"},"isMultiple":{"type":"boolean","default":false,"description":"If checked comma will be handled as search for multiple terms"},"viewedFrom":{"enum":["","us","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","ba","bw","bv","br","io","bn","bg","bf","bi","kh","cm","ca","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","fr","gf","pf","tf","ga","gm","ge","de","gh","gi","gr","gl","gd","gp","gu","gt","gn","gw","gy","ht","hm","va","hn","hk","hu","is","in","id","ir","iq","ie","il","it","jm","jp","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","nl","an","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","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","um","uy","uz","vu","ve","vn","vg","vi","wf","eh","ye","zm","zw"],"type":"string","description":"Country for residential proxies to ensure correct results"},"searchTerms":{"type":"array","items":{"type":"string"},"description":"(Required if 'spreadsheetId' is not provided) List of search terms to be scraped."},"spreadsheetId":{"type":"string","description":"(Optional) Id of the google sheet from where search terms will be loaded. Spreadsheet must have only one column. Row 1 is considered the title of the column so it will not be loaded as a search term. The provided spreadsheet must be publicly available. Check the actor documentation for more info."},"maxConcurrency":{"type":"integer","default":10,"maximum":9007199254740991,"minimum":1,"description":"How many pages will be opened in parallel if enough CPU is available."},"customTimeRange":{"type":"string","description":"Provide custom time range. If present, it takes precedence over regular timeRange. Format is: `YYYY-MM-DD YYYY-MM-DD`. See examples in the documentation."},"skipDebugScreen":{"type":"boolean","default":false,"description":"By default snapshot of each visited Google Trends page saved to KV Store"},"maxRequestRetries":{"type":"integer","default":7,"maximum":9007199254740991,"minimum":1,"description":"How many times will the actor retry a request if it fails."},"pageLoadTimeoutSecs":{"type":"integer","default":180,"maximum":9007199254740991,"minimum":30,"description":"How long it will wait for page loading before it abandons the loading and tries again."}},"description":"Normalized actor input. See field descriptions for the simplified shape; native Apify input also accepted (passed through).","additionalProperties":{}},"options":{"type":"object","properties":{"build":{"type":"string","maxLength":100,"minLength":1},"memory":{"type":"integer","maximum":32768,"minimum":128},"maxItems":{"type":"integer","maximum":100000,"minimum":1}},"description":"Optional Apify run options.","additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"username":"sarptecimer","includeEmail":false},"options":{"memory":256,"maxItems":100}},"response":{"run":{"id":"3md6z4vJgdX861xdC","status":"READY","actorId":"DyNQEYDj9awfGQf9A","startedAt":"2026-06-16T17:44:37.125Z","usageTotalUsd":0.00005,"defaultDatasetId":"HSPefHzi1BetdZM8w"},"token":"eyJhbGciOiJIUzI1NiJ9.eyJydW5JZCI6IjNtZDZ6NHZKZ2RYODYxeGRDIiwiYWN0b3JJZCI6ImFwaWZ5L2dvb2dsZS10cmVuZHMtc2NyYXBlciIsImRlZmF1bHREYXRhc2V0SWQiOiJIU1BlZkh6aTFCZXRkWk04dyIsInciOiIweDljYzQyZjNkOTI0NWI4NjdhY2NjZDYzMGI0M2Y5MDZjMTY2NWIxNzYiLCJpYXQiOjE3ODE2MzE4NzcsImV4cCI6MTc4NDIyMzg3N30.uBdinFMwe9ks63WKJl5zFV9Kygi8hwbFGr9VRI5SaJc"}},"exampleRequest":{"input":{"username":"sarptecimer","includeEmail":false},"options":{"memory":256,"maxItems":100}},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4kl-k-gKxWoWXfUwY7DBv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Starts an Apify actor run that scrapes Google Trends data by search terms or URLs, returning interest over time and by subregion","exampleAgentPrompt":"Can you scrape Google Trends data for 'electric vehicles' in the United States over the past 12 months, broken down by subregion, and give me the interest-over-time scores?","exampleUseCases":[{"title":"Brand awareness trend monitoring","prompt":"Scrape Google Trends for 'Nike' and 'Adidas' in the US over the past 5 years so I can compare how search interest in both brands has shifted over time."},{"title":"Seasonal demand research for a product","prompt":"Pull Google Trends data for 'pumpkin spice' globally for the last 3 years — I want to see how interest spikes by season and which subregions are most engaged."},{"title":"Market entry research by region","prompt":"Get me Google Trends interest by subregion for 'plant-based protein' in Germany over the past 2 years so I can identify which states or cities show the strongest consumer interest."}],"resultDescription":"Returns an actor run object with a run ID, status (READY), actor ID, start timestamp, estimated usage cost, default dataset ID, and a JWT token used to fetch scraped results from the dataset once the run completes.","failureModes":["Invalid or unsupported search term format returns an actor error","Overly broad time ranges or many keywords may exceed memory limits (default 256MB)","Google Trends rate limiting or CAPTCHA challenges can cause the actor run to fail or return incomplete data","Actor run starts successfully but dataset is empty if Google Trends returns no results for the given inputs","Token expiry (30 days) prevents dataset retrieval if results are fetched too late"],"whenToPreferThis":"Choose this endpoint when you need programmatic access to Google Trends data — interest over time, interest by subregion, or related queries — for one or more search terms with configurable location, time range, and category filters. It is preferable over manual Google Trends exports when automation, scale, or integration into an agent workflow is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:50:58.515Z","isFirstParty":false}