{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper API: Trending Now & Watch List", "description": "Fast Google Trends scraper and API, no browser. Get interest over time, by region, rising queries, keyword comparisons and up to 500 Trending Now searches per country with volume, growth and news. Watch list alerts for your brand. $2 or less per 1,000 results, failed items free.", "version": "1.0", "x-build-id": "6PUY2SoGWn9jtZLP3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/inter974~google-trends-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-inter974-google-trends-api", "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/inter974~google-trends-api/runs": { "post": { "operationId": "runs-sync-inter974-google-trends-api", "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/inter974~google-trends-api/run-sync": { "post": { "operationId": "run-sync-inter974-google-trends-api", "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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "One search term per line. To compare terms on the same 0-100 scale (like the Compare button in Google Trends), put up to 5 terms on one line separated by commas, e.g. 'bitcoin, ethereum, solana'.", "items": { "type": "string" } }, "geo": { "title": "Location", "type": "string", "description": "Country or region code: 'US', 'FR', 'GB', 'DE', or a sub-region like 'US-CA'. Leave empty for worldwide.", "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" ], "type": "string", "description": "Period to analyse. Ignored when a custom range is set.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Optional. Format 'YYYY-MM-DD YYYY-MM-DD', e.g. '2024-01-01 2024-12-31'. Overrides the time range above." }, "category": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Google Trends category ID (0 = all categories). Examples: 7 Finance, 12 Business & Industrial, 18 Shopping, 45 Health, 958 Jobs & Education.", "default": 0 }, "searchProperty": { "title": "Search type", "enum": [ "", "images", "news", "froogle", "youtube" ], "type": "string", "description": "Which Google search to analyse.", "default": "" }, "includeInterestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Time series (0-100) plus a summary: average, peak, latest value, % change and trend direction.", "default": true }, "includeInterestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Where the keyword is most popular, ranked by interest (0-100).", "default": true }, "regionResolution": { "title": "Region resolution", "enum": [ "", "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Granularity of 'Interest by region'. Leave on Automatic to use Google's default for the location.", "default": "" }, "includeRelatedQueries": { "title": "Related queries (top + rising)", "type": "boolean", "description": "Top related searches and the fastest-rising ones, with growth % or 'Breakout'.", "default": true }, "includeRelatedTopics": { "title": "Related topics (top + rising)", "type": "boolean", "description": "Since 2026 Google returns empty related-topic lists for most searches. Off by default to save time; turn on to try anyway (empty lists are simply omitted).", "default": false }, "trendingGeos": { "title": "Trending now - countries", "type": "array", "description": "Get the searches trending right now (like trends.google.com/trending) for these country codes, e.g. 'US', 'FR', 'IN': search volume, % increase, related searches, categories, start time, and news articles for the top trends. Can be used alone or together with search terms.", "items": { "type": "string" } }, "trendingHours": { "title": "Trending now - period", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Trends that started in this window.", "default": "24" }, "trendingCategories": { "title": "Trending now - categories", "type": "array", "description": "Only keep trends in these categories. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "13", "14", "15", "16", "17", "18", "19", "20" ], "enumTitles": [ "Autos and Vehicles", "Beauty and Fashion", "Business and Finance", "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", "Climate" ] } }, "trendingWatchList": { "title": "Trending now - watch list", "type": "array", "description": "Only return trends that mention these words or phrases (your brand, competitors, topics) in the trending search, its related searches or its news headlines. Case and accents are ignored; whole words only. All trends are scanned, but you only pay for the matches - ideal for monitoring and alerts.", "items": { "type": "string" } }, "maxTrendingItems": { "title": "Max trending searches per country", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of trending searches returned per country, ranked by search volume (up to 500).", "default": 25 }, "includeTrendingNews": { "title": "Trending now - news articles", "type": "boolean", "description": "Attach up to 3 news articles (title, link, source, date, picture) to each trending search.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Language for topic names and labels, e.g. 'en-US', 'fr', 'de'.", "default": "en-US" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many search terms are processed at the same time. Higher is faster but more likely to be rate-limited by Google.", "default": 3 }, "maxRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 15, "type": "integer", "description": "How many times a blocked request is retried on a fresh IP. Inputs still blocked are retried once more at the end of the run, after a pause. Failed inputs are never charged.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google rate-limits heavily. Residential proxies give the best success rate.", "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 } } } } } } } } } }