{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper β€” Trending Now, Keywords & News", "description": "Every trending search on Google Trends for 125 countries and any US state or region β€” search volume, % growth, start/end time, categories, related searches, news articles and minute-level interest over time. Plus keyword interest over time, related queries and regions. No login.", "version": "0.1", "x-build-id": "6katNeDJQsqWTSqEH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~google-trends-trending-now/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-google-trends-trending-now", "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/yugenox~google-trends-trending-now/runs": { "post": { "operationId": "runs-sync-yugenox-google-trends-trending-now", "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/yugenox~google-trends-trending-now/run-sync": { "post": { "operationId": "run-sync-yugenox-google-trends-trending-now", "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": [ "trendingNow", "keywords", "both" ], "type": "string", "description": "Trending Now: every trending search for each country / region (with volume, growth, categories, and optional news + interest over time). Keywords: interest over time, related queries and regional interest for your own keywords. Both: do both in one run.", "default": "trendingNow" }, "geos": { "title": "🌍 Countries / regions", "type": "array", "description": "Country codes (US, CA, GB, IN, DE, BR…), US states and other regions (US-NY, US-CA, IN-MH, CA-ON), or country names. Use ALL_COUNTRIES for all 125 countries that have Trending Now. For keyword mode, WORLDWIDE is also accepted (and is the default when this is empty).", "items": { "type": "string" } }, "hours": { "title": "⏱️ Trending in the past", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "The Trending Now time window.", "default": "24" }, "includeNews": { "title": "πŸ“° News articles for each trend", "type": "boolean", "description": "Attach the news articles Google shows for each trend (title, URL, source, publish time, image).", "default": false }, "maxNewsPerTrend": { "title": "πŸ“° Max articles per trend", "minimum": 1, "maximum": 30, "type": "integer", "description": "Up to 30.", "default": 10 }, "includeTrendTimeline": { "title": "πŸ“ˆ Interest over time for each trend", "type": "boolean", "description": "Attach a search-interest time series for each trend over its own time window: 8-minute points for trends from the last day, 1-minute points for short trends that already ended, hourly points for older ones. Adds 2 requests per trend, so runs take longer.", "default": false }, "categories": { "title": "🏷️ Categories", "type": "array", "description": "Only keep trends in these categories. Leave empty for all categories. Filtered-out trends are not saved and not charged.", "items": { "type": "string", "enum": [ "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" ] } }, "activeOnly": { "title": "πŸ”₯ Active trends only", "type": "boolean", "description": "Only keep trends that are still rising (Google marks the others as ended).", "default": false }, "minSearchVolume": { "title": "Min search volume", "minimum": 0, "type": "integer", "description": "Only keep trends with at least this many searches (Google buckets: 100, 200, 500, 1000, 2000, 5000, 10000, 20000, 50000, 100000, 200000, 500000, 1000000+)." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "searchVolume", "recency", "percentIncrease", "title" ], "type": "string", "description": "Order of trends within each country / region.", "default": "relevance" }, "maxTrendsPerGeo": { "title": "Max trends per country / region", "minimum": 1, "type": "integer", "description": "For example 25 to get the top 25 trends of each country. Leave empty for all of them." }, "language": { "title": "πŸ—£οΈ Language", "type": "string", "description": "Language code for Google Trends, e.g. en-US, en-GB, fr, de, es-419, hi, ja.", "default": "en-US" }, "keywords": { "title": "πŸ” Keywords", "type": "array", "description": "Keyword mode: search terms to look up (one row per keyword and country / region).", "items": { "type": "string" } }, "compareKeywords": { "title": "βš–οΈ Compare keywords", "type": "boolean", "description": "On: keywords are compared in groups of up to 5, on one shared 0–100 scale (like adding terms to a comparison on Google Trends). Off: each keyword gets its own 0–100 scale.", "default": false }, "timeframe": { "title": "πŸ“… Timeframe", "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": "Time range for keyword mode.", "default": "today 3-m" }, "customTimeframe": { "title": "πŸ“… Custom timeframe", "type": "string", "description": "Overrides Timeframe. \"2026-01-01 2026-06-30\" for dates, or \"2026-09-20T00 2026-09-21T00\" for UTC hours within the last 7 days (up to 8h gives 1-minute points, up to 24h gives 8-minute points)." }, "stitch8MinDays": { "title": "🧡 8-minute data for the last N days", "minimum": 0, "maximum": 7, "type": "integer", "description": "Google only gives 8-minute resolution for one day at a time. Set 2–7 to get an 8-minute series over the last N days, stitched from overlapping 24-hour windows onto one scale. Replaces Timeframe for the time series. 0 = off.", "default": 0 }, "includeRelatedQueries": { "title": "πŸ”— Related queries (top + rising)", "type": "boolean", "description": "Top and rising related searches for each keyword, including \"Breakout\" terms.", "default": true }, "includeRegions": { "title": "πŸ—ΊοΈ Interest by region", "type": "boolean", "description": "Where each keyword is searched most (states / provinces for a country, countries for worldwide).", "default": true }, "regionResolution": { "title": "Region level", "enum": [ "REGION", "DMA", "CITY", "COUNTRY" ], "type": "string", "description": "Optional. Region: states / provinces. Metro (DMA): US metro areas (US only). City: cities. Country: countries (worldwide only)." }, "exploreCategory": { "title": "Search category id", "minimum": 0, "type": "integer", "description": "Optional Google Trends search category for keyword mode. 0 = all categories. Common ids: 3 Arts & Entertainment, 5 Computers & Electronics, 7 Finance, 12 Business & Industrial, 16 News, 18 Shopping, 20 Sports, 29 Real Estate, 45 Health, 47 Autos & Vehicles, 67 Travel, 71 Food & Drink.", "default": 0 }, "searchProperty": { "title": "Search type", "enum": [ "web", "news", "images", "youtube", "shopping" ], "type": "string", "description": "Which Google search to measure in keyword mode.", "default": "web" }, "maxItems": { "title": "πŸ”’ Max results", "minimum": 1, "type": "integer", "description": "Maximum number of rows for the whole run. Leave empty for no limit." }, "maxConcurrency": { "title": "Parallel sessions", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many proxy sessions work in parallel. 4 is a good balance; higher is faster for big timeline or keyword jobs.", "default": 4 }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Apify datacenter proxy works well and is the default. Throttled sessions rotate automatically, with a residential fallback. If your Apify plan has no residential proxies, throttled keyword lookups and timelines wait 30-60 s and retry on fresh addresses instead (slower).", "default": { "useApifyProxy": true } }, "_noResidential": { "title": "Run as an account without residential proxies", "type": "boolean", "description": "Internal (canaries): behave exactly like an account without the RESIDENTIAL proxy group.", "default": false } } }, "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 } } } } } } } } } }