{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper – Interest Over Time & Related Queries", "description": "Google Trends Scraper: get interest over time, interest by region, related queries and trending searches for any keyword. Compare keywords and pick country, timeframe, category and Google property (web, YouTube, news, images, shopping). Clean rows for CSV, Excel, JSON or API.", "version": "1.0", "x-build-id": "mQSfCZnUzJ7uOR3Bu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maged120~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maged120-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/maged120~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-maged120-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/maged120~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-maged120-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Search terms to analyze. Up to 5 are compared on one 0-100 scale. Turn off 'Compare keywords' to research up to 50 keywords, each on its own scale.", "default": [ "artificial intelligence" ], "items": { "type": "string" } }, "compareKeywords": { "title": "Compare keywords", "type": "boolean", "description": "On: up to 5 keywords share one chart, so their values are comparable. Off: each keyword (up to 50) is fetched on its own, for long keyword lists.", "default": true }, "dataTypes": { "title": "Data Types to Fetch", "type": "array", "description": "Which Google Trends data to collect. Related queries gives the top and rising searches for each keyword. Trending now gives today's trending searches for the country in 'Country / region' (US if empty) and needs no keywords.", "items": { "type": "string", "enum": [ "interestOverTime", "interestByRegion", "relatedQueries", "trendingNow" ], "enumTitles": [ "Interest over time", "Interest by region", "Related queries (top and rising)", "Trending now (daily trending searches for the country)" ] }, "default": [ "interestOverTime", "interestByRegion" ] }, "geo": { "title": "Country / Region", "type": "string", "description": "ISO 3166-1 alpha-2 country code (e.g. US, GB, DE). Leave empty for worldwide data. Use ISO 3166-2 for sub-regions (e.g. US-NY for New York).", "default": "" }, "timeframe": { "title": "Timeframe", "enum": [ "past_hour", "past_4_hours", "past_day", "past_7_days", "past_30_days", "past_90_days", "past_12_months", "past_5_years", "2004_to_present", "custom" ], "type": "string", "description": "Time range for trend data. Use 'custom' to specify an exact date range below.", "default": "past_30_days" }, "customTimeframe": { "title": "Custom Date Range", "type": "string", "description": "Custom date range in 'YYYY-MM-DD YYYY-MM-DD' format (e.g. '2020-01-01 2023-12-31'). Only applies when Timeframe is set to 'Custom date range'.", "default": "" }, "category": { "title": "Category", "enum": [ "0", "57", "71", "13", "903", "7", "543", "8", "174", "766", "11", "31", "958", "275", "179", "65", "276", "328", "19" ], "type": "string", "description": "Filter results to a specific Google Trends category. Defaults to All categories.", "default": "0" }, "gprop": { "title": "Search Type", "enum": [ "web", "images", "news", "youtube", "shopping" ], "type": "string", "description": "Google property to filter results by search type.", "default": "web" }, "regionResolution": { "title": "Regional Breakdown", "enum": [ "COUNTRY", "REGION", "DMA", "CITY" ], "type": "string", "description": "Geographic resolution for Interest by Region data. COUNTRY works worldwide; REGION/DMA/CITY require a specific geo.", "default": "COUNTRY" }, "language": { "title": "Language", "type": "string", "description": "Language for results as a BCP 47 tag (e.g. en-US, de-DE, fr-FR, ja-JP, zh-CN). Affects labels and related content language.", "default": "en-US" }, "timezoneOffset": { "title": "Timezone Offset (minutes)", "minimum": -720, "maximum": 840, "type": "integer", "description": "UTC offset in minutes. Affects timeframe boundaries. Examples: -300 = EST (UTC-5), 0 = UTC, 60 = CET (UTC+1), 330 = IST (UTC+5:30).", "default": 0 } } }, "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 } } } } } } } } } }