{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Get instant access to 🔥 daily trending searches by country and analyze Google Trends keyword search trends. This ultimate API alternative gives developers and data scientists programmatic access to Google Trends data without limitations.", "version": "2.7", "x-build-id": "orPMF8p9OPY4D1Frm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_xplorer~google-trends-fast-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_xplorer-google-trends-fast-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/data_xplorer~google-trends-fast-scraper/runs": { "post": { "operationId": "runs-sync-data_xplorer-google-trends-fast-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/data_xplorer~google-trends-fast-scraper/run-sync": { "post": { "operationId": "run-sync-data_xplorer-google-trends-fast-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": { "enableTrendingSearches": { "title": "Enable Trending Searches Mode", "type": "boolean", "description": "Enable to only retrieve trending searches (keyword analysis will be ignored)", "default": true }, "trendingSearchesCountry": { "title": "Country for Trending Searches", "enum": [ "US", "FR", "GB", "DE", "IT", "ES", "BR", "AU", "IN", "CA", "RU", "JP", "NL", "PL", "TR", "BE", "SE", "CH", "AT", "MX", "DK", "NO", "FI", "NZ", "SG", "ZA", "IE", "HK", "PT", "GR", "IL", "AR", "CL", "CO", "HU", "MY", "PH", "RO", "SA", "TH", "AE", "VN", "KR", "TW", "ID" ], "type": "string", "description": "Select a country for trending searches (required if trending searches is enabled)", "default": "US" }, "trendingSearchesTimeframe": { "title": "Time Period for Trending Searches", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Select a time period for trending searches", "default": "24" }, "trendingSearchesCategories": { "title": "Categories Filter (Optional)", "uniqueItems": true, "type": "array", "description": "Select one or more categories to filter trending searches (leave empty for all categories)", "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" ] }, "default": [] }, "trendingSearchesMaxItems": { "title": "Max Trending Items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of trending search results to return. Leave empty for default (50)." }, "keyword": { "title": "Search Term", "type": "string", "description": "The keyword to analyze in Google Trends", "default": "bitcoin" }, "predefinedTimeframe": { "title": "Time Period", "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": "Select a time period", "default": "today 12-m" }, "geo": { "title": "Country", "enum": [ "", "AF", "ZA", "AL", "DZ", "DE", "AD", "AO", "AI", "AG", "SA", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BE", "BZ", "BJ", "BM", "BT", "BY", "BO", "BA", "BW", "BR", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "CL", "CN", "CY", "CO", "KM", "CG", "CD", "KP", "KR", "CR", "CI", "HR", "CU", "CW", "DK", "DJ", "DM", "EG", "AE", "EC", "ER", "ES", "EE", "US", "ET", "FJ", "FI", "FR", "GA", "GM", "GE", "GH", "GI", "GR", "GL", "HK", "HU", "IN", "ID", "IQ", "IR", "IE", "IS", "IL", "IT", "JM", "JP", "JO", "KZ", "KE", "KW", "LA", "LV", "LB", "LY", "LT", "LU", "MO", "MY", "MV", "MT", "MA", "MX", "MC", "MN", "ME", "MZ", "MM", "NA", "NP", "NI", "NG", "NO", "NZ", "OM", "UG", "UZ", "PK", "PA", "PY", "NL", "PE", "PH", "PL", "PT", "QA", "RO", "GB", "RU", "RW", "SN", "RS", "SG", "SK", "SI", "SO", "LK", "SE", "CH", "TW", "TJ", "TZ", "TH", "TN", "TR", "UA", "UY", "VE", "VN", "YE", "ZM", "ZW" ], "type": "string", "description": "Select a country for keyword trends", "default": "" }, "fetchRegionalData": { "title": "Regional Data", "type": "boolean", "description": "Enable to retrieve regional data", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Select proxies to be used by your Actor", "default": { "useApifyProxy": true } } } }, "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 } } }, "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 } } } } } } } } } }