{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper & API - Trending Now, Pinterest Trends", "description": "Google Trends scraper and API, no login: Trending Now in 125 countries, interest over time, by region, related, rising searches; compare keywords across countries, CSV tables. Pinterest Trends: growing searches, shopping trends, seasonal moments. Trend monitor with Slack, Discord, Telegram alerts.", "version": "0.1", "x-build-id": "60BU4jqOXG5zXSNeJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/akhil_rajesh~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-akhil_rajesh-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/akhil_rajesh~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-akhil_rajesh-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/akhil_rajesh~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-akhil_rajesh-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": { "trendingCountries": { "title": "Trending Now: countries or regions", "type": "array", "description": "Every search trending in each place, as trends.google.com/trending lists it: search volume, increase, when it started, whether it's still active, the searches Google groups under it and its categories. Pick countries, or type a region's code (US-CA, CA-ON, IN-MH) or name ('California', 'Ontario, Canada'). 125 countries and their regions.", "items": { "type": "string", "enumSuggestedValues": [ "AL", "DZ", "AO", "AR", "AM", "AU", "AT", "AZ", "BH", "BD", "BY", "BE", "BJ", "BO", "BA", "BR", "BG", "BF", "KH", "CM", "CA", "CL", "CO", "CD", "CR", "HR", "CU", "CY", "CZ", "CI", "DK", "DO", "EC", "EG", "SV", "EE", "ET", "FI", "FR", "GE", "DE", "GH", "GR", "GT", "HT", "HN", "HK", "HU", "IN", "ID", "IR", "IQ", "IE", "IL", "IT", "JM", "JP", "JO", "KZ", "KE", "KW", "KG", "LV", "LB", "LY", "LT", "MY", "ML", "MX", "MD", "MA", "MZ", "MM", "NP", "NL", "NZ", "NI", "NG", "MK", "NO", "OM", "PK", "PS", "PA", "PY", "PE", "PH", "PL", "PT", "PR", "QA", "RO", "RU", "SA", "SN", "RS", "SG", "SK", "SI", "ZA", "KR", "ES", "LK", "SE", "CH", "SY", "TW", "TZ", "TH", "TT", "TN", "TM", "TR", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VE", "VN", "YE", "ZM", "ZW" ], "enumTitles": [ "Albania", "Algeria", "Angola", "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Belarus", "Belgium", "Benin", "Bolivia", "Bosnia & Herzegovina", "Brazil", "Bulgaria", "Burkina Faso", "Cambodia", "Cameroon", "Canada", "Chile", "Colombia", "Congo - Kinshasa", "Costa Rica", "Croatia", "Cuba", "Cyprus", "Czechia", "Côte d’Ivoire", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Finland", "France", "Georgia", "Germany", "Ghana", "Greece", "Guatemala", "Haiti", "Honduras", "Hong Kong", "Hungary", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kazakhstan", "Kenya", "Kuwait", "Kyrgyzstan", "Latvia", "Lebanon", "Libya", "Lithuania", "Malaysia", "Mali", "Mexico", "Moldova", "Morocco", "Mozambique", "Myanmar (Burma)", "Nepal", "Netherlands", "New Zealand", "Nicaragua", "Nigeria", "North Macedonia", "Norway", "Oman", "Pakistan", "Palestine", "Panama", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Saudi Arabia", "Senegal", "Serbia", "Singapore", "Slovakia", "Slovenia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sweden", "Switzerland", "Syria", "Taiwan", "Tanzania", "Thailand", "Trinidad & Tobago", "Tunisia", "Turkmenistan", "Türkiye", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Venezuela", "Vietnam", "Yemen", "Zambia", "Zimbabwe" ] } }, "trendingHours": { "title": "Trending in the past", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Trending Now's time window. 24 hours lists about 700 US trends, 7 days about 3,400.", "default": "24" }, "trendingCategories": { "title": "Trend categories", "type": "array", "description": "Only trends Google puts in these categories. Empty: all.", "items": { "type": "string", "enumSuggestedValues": [ "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" ], "enumTitles": [ "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" ] } }, "activeTrendsOnly": { "title": "Active trends only", "type": "boolean", "description": "Only trends Google still marks as active (searches still rising)." }, "minSearchVolume": { "title": "Minimum search volume", "minimum": 0, "type": "integer", "description": "Only trends with at least this many searches (Google's buckets: 100+, 200+, 500+, 1K+, 2K+, 5K+, 10K+ ... 1M+). Empty: any." }, "trendKeywords": { "title": "Trends containing", "type": "array", "description": "Only trends whose search term, or a search Google groups under it, contains one of these words or phrases (whole words, accents and case aside). Watch a brand, a niche or a topic.", "items": { "type": "string" } }, "sortTrendsBy": { "title": "Sort trends by", "enum": [ "relevance", "searchVolume", "recency", "increase" ], "type": "string", "description": "The order trends are returned in, and so which ones Trends per country keeps.", "default": "relevance" }, "maxTrendsPerCountry": { "title": "Trends per country or region", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Most trends a run returns for each place, after the filters and the sort. With Only changes, it caps the changes reported for each place, and the rest come with the next run: raise it for a daily schedule.", "default": 50 }, "includeNews": { "title": "Include news articles", "type": "boolean", "description": "Each trend's news articles (title, source, link, time), as the trend's page shows them. One more request per trend, so a run takes longer." }, "newsPerTrend": { "title": "Articles per trend", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many articles each trend gets with Include news articles.", "default": 3 }, "keywords": { "title": "Keywords", "type": "array", "description": "Interest over time for each keyword, with its average, peak, latest and growth (rising / steady / falling), interest by region, and related searches, top and rising (the breakouts). One row per keyword. Put terms in one entry with commas to compare them on one scale, as Explore does ('coke, pepsi'). A topic id from an Explore link (/m/07ykbs) reads the topic, and its row names it.", "items": { "type": "string" } }, "compareKeywords": { "title": "Compare keywords", "type": "boolean", "description": "Put all the keywords on one scale, as Explore's comparison does: groups of 5, in the order typed. Each row's interest is then relative to the group's peak, and its regions show each keyword's share. Off: each keyword on its own 0-100 scale, except entries that list terms with commas, which are always compared." }, "trendsUrls": { "title": "Google Trends links", "type": "array", "description": "Paste links from Google Trends: an Explore chart (trends.google.com/trends/explore?q=...) is read with its own terms, place, period, category and search type; a Trending Now page (trends.google.com/trending?geo=...) adds its place, with its window and filters when this form sets none; a Pinterest Trends link adds its region. Links are read, never opened.", "items": { "type": "string" } }, "keywordsSheet": { "title": "Keywords from a Google Sheet", "type": "string", "description": "A Google Sheet's link or id: its first column is read as keywords from row 2 (row 1 is the column's title), added to the keywords above. Share the sheet as 'Anyone with the link' (Viewer). The tab in the link (#gid=) is the one read." }, "timeframe": { "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": "The period for the keywords' interest over time. Start and end dates below override it.", "default": "today 12-m" }, "timeframeStart": { "title": "Custom range: start date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "A custom period from this day (2004-01-01 or later, UTC). End date empty: until today." }, "timeframeEnd": { "title": "Custom range: end date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "The custom period's last day (UTC)." }, "exploreGeo": { "title": "Keywords' countries or regions", "type": "string", "description": "Where the keywords' searches are counted: a country or region code or name (US, India, US-CA, 'Bavaria'). Several, separated by commas (US, GB, India): each keyword is read in each, one row per place. Empty: worldwide." }, "exploreCategory": { "title": "Keywords' category", "type": "string", "description": "Narrow the keywords to searches in one of Google's 1,133 categories, by name or id ('Coffee & Tea', 'Beauty & Fitness', 71). Empty: all categories." }, "searchType": { "title": "Search type", "enum": [ "web", "images", "news", "youtube", "shopping" ], "type": "string", "description": "Which searches count: web search, image search, news search, YouTube search or Google Shopping.", "default": "web" }, "regionLevel": { "title": "Region level", "enum": [ "auto", "country", "region", "city", "metro" ], "type": "string", "description": "How finely interest by region is broken down. Auto: Google's own (countries worldwide, regions in a country). Metro areas exist for the United States only.", "default": "auto" }, "exploreData": { "title": "Keyword data", "type": "array", "description": "What each keyword row holds. Empty: all three.", "items": { "type": "string", "enum": [ "interestOverTime", "interestByRegion", "relatedQueries" ], "enumTitles": [ "Interest over time", "Interest by region", "Related searches (top and rising)" ] } }, "pinterestRegions": { "title": "Pinterest Trends: regions", "type": "array", "description": "What Pinterest users search and save, from trends.pinterest.com: the fastest-growing searches with their weekly, monthly and yearly change, trends in the spotlight, shopping trends, editors' picks and seasonal moments. Pinterest shows 26 regions; a country it groups with others (Australia, Ireland, Sweden) reads its group.", "items": { "type": "string", "enumSuggestedValues": [ "US", "GB+IE", "CA", "IT+ES+PT+GR+MT", "IT", "ES", "DE+AT+CH", "DE", "FR", "SE+DK+FI+NO", "NL+BE+LU", "PL+RO+HU+SK+CZ", "MX+AR+CO+CL", "CO", "AR", "MX", "BR", "AU+NZ", "MY", "PH", "TH", "EG", "TR", "KR", "CR+DO+EC+GT+PE", "CY+CZ+GR+HU+MT+PL+RO+SK" ], "enumTitles": [ "United States", "Great Britain and Ireland", "Canada", "Southern Europe", "Italy", "Spain", "Germanic countries", "Germany", "France", "Nordic countries", "Benelux", "Eastern Europe", "Hispanic LatAm", "Colombia", "Argentina", "Mexico", "Brazil", "Australasia", "Malaysia", "Philippines", "Thailand", "Egypt", "Turkey", "Korea", "Latin America & Caribbean", "Eastern Europe & Mediterranean" ] } }, "pinterestLists": { "title": "Pinterest lists", "type": "array", "description": "Which of Pinterest Trends' lists to read. Empty: all five. Pinterest shows trends in the spotlight, shopping trends and editors' picks for the United States, Canada, and Great Britain and Ireland only; other regions get their fastest-growing searches and moments.", "items": { "type": "string", "enum": [ "searchTrends", "spotlight", "shopping", "editorsPicks", "moments" ], "enumTitles": [ "Fastest-growing searches", "Trends in the spotlight", "Shopping trends", "Editors' picks", "Moments" ] } }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Most charged rows a run returns (trends, keywords with data, Pinterest rows), shared between the searches. With Only changes: most changes; the rest come with the next run.", "default": 1000 }, "onlyChanges": { "title": "Only changes since the last run", "type": "boolean", "description": "Monitor: each run returns only what's new since the last run with the same settings: new trends in a country, a keyword's new rising searches, new entries on Pinterest's lists, moments taking off. Keyword rows are always returned, with what changed marked. The first run saves what's listed as the baseline and returns it as firstRun. Schedule it (every hour, every day)." }, "changeTypes": { "title": "Changes to report", "type": "array", "description": "With Only changes. Empty: new trends, new rising searches, new on Pinterest, moments taking off.", "items": { "type": "string", "enum": [ "newTrend", "volumeUp", "newRisingQuery", "directionChanged", "newOnPinterest", "momentRising" ], "enumTitles": [ "New trends (Trending Now)", "Trends that reached a higher search volume", "New rising searches for a keyword", "A keyword's direction changed", "New on a Pinterest list", "A Pinterest moment taking off" ] } }, "alertWebhookUrl": { "title": "Alert webhook URL", "type": "string", "description": "Post each run's changes to Slack, Discord or Microsoft Teams (their incoming-webhook URL), or to any HTTPS endpoint that takes JSON (Zapier, Make, n8n). Switches on Only changes. The first run posts a short 'alerts are set up' message." }, "telegramBotToken": { "title": "Telegram bot token (alerts to Telegram)", "type": "string", "description": "Post each run's changes to a Telegram chat through your own bot: its token from @BotFather (123456789:AAH...). Add the bot to the chat (to a channel as an admin that can post). Switches on Only changes." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Where the bot posts: a public channel or group (@mychannel), or a chat id (-1001234567890 for a private group or channel; your own id for a direct message, from @userinfobot)." }, "alertChangeTypes": { "title": "Alert on", "type": "array", "description": "Which changes to post (up to 50 a run, the most important first; all are in the dataset). Empty: new trends, new rising searches, new on Pinterest, moments taking off.", "items": { "type": "string", "enum": [ "newTrend", "volumeUp", "newRisingQuery", "directionChanged", "newOnPinterest", "momentRising" ], "enumTitles": [ "New trends (Trending Now)", "Trends that reached a higher search volume", "New rising searches for a keyword", "A keyword's direction changed", "New on a Pinterest list", "A Pinterest moment taking off" ] } }, "historyName": { "title": "History name", "type": "string", "description": "Keep a separate history for this monitor (a-z, 0-9 and hyphens). Leave empty to share the default one: histories are kept per search and settings anyway." }, "proxy": { "title": "Proxy", "type": "object", "description": "Not needed: Google Trends and Pinterest Trends answer Apify's servers directly. You can use your own proxies or Apify's datacenter proxies; residential proxies aren't available in this Actor." } } }, "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 } } } } } } } } } }