{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Extract Google Trends data: daily trending searches, keyword interest over time, related queries and topics, regional interest. 150+ countries, category filters, Google property selection (Web, YouTube, News, Images, Shopping). From $1 per 1,000 trending results.", "version": "0.0", "x-build-id": "c69GkRZWfzoTTwJmt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourabhbgp~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourabhbgp-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/sourabhbgp~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-sourabhbgp-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/sourabhbgp~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-sourabhbgp-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "trending", "explore" ], "type": "string", "description": "'trending' = daily trending searches by country. 'explore' = keyword interest over time, related queries/topics, and regional interest.", "default": "trending" }, "keywords": { "title": "Keywords", "type": "string", "description": "Comma-separated keywords to analyze. Used in 'explore' mode. Example: 'bitcoin, ethereum, solana'. Max 100 keywords." }, "geo": { "title": "Country", "type": "string", "description": "ISO 2-letter country code (e.g., US, GB, DE, JP). Leave empty for worldwide. If you omit this field entirely, the search runs worldwide rather than the US shown in the form.", "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" ], "type": "string", "description": "Time range for explore mode data.", "default": "today 12-m" }, "category": { "title": "Category", "enum": [ "0", "3", "47", "44", "22", "12", "5", "7", "71", "8", "45", "64", "11", "13", "958", "19", "16", "299", "14", "66", "29", "533", "174", "18", "20", "67" ], "type": "string", "description": "Filter explore results by category.", "default": "0" }, "googleProperty": { "title": "Google Property", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Filter by Google property.", "default": "" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum trending items per day. Google's RSS feed returns up to ~10 items per day, so values above 10 have no effect. With daysBack > 1, this caps each day independently (not total). Used in 'trending' mode only.", "default": 10 }, "language": { "title": "Language", "enum": [ "en-US", "en-GB", "pt-BR", "pt-PT", "es-ES", "es-MX", "fr-FR", "de-DE", "it-IT", "ja-JP", "ko-KR", "zh-CN", "zh-TW", "ru-RU", "hi-IN", "ar-SA" ], "type": "string", "description": "Locale code passed to Google Trends as 'hl'. Affects label/region/related-query language. Used in both modes.", "default": "en-US" }, "timezone": { "title": "Timezone", "enum": [ "UTC", "America/New_York", "America/Chicago", "America/Denver", "America/Los_Angeles", "America/Sao_Paulo", "America/Mexico_City", "America/Toronto", "Europe/London", "Europe/Paris", "Europe/Berlin", "Europe/Madrid", "Europe/Moscow", "Africa/Cairo", "Africa/Johannesburg", "Asia/Dubai", "Asia/Kolkata", "Asia/Shanghai", "Asia/Tokyo", "Asia/Seoul", "Asia/Singapore", "Australia/Sydney" ], "type": "string", "description": "IANA timezone name. Determines which 'today' Google returns for trending. Used in trending mode.", "default": "UTC" }, "daysBack": { "title": "Days Back", "minimum": 1, "maximum": 90, "type": "integer", "description": "Number of days of trending data to fetch (ending on 'date'). 1 = current day only. Used in trending mode.", "default": 1 }, "date": { "title": "End Date (YYYY-MM-DD)", "type": "string", "description": "End date of the daysBack window. Defaults to today in the chosen timezone. Format: YYYY-MM-DD. Used in trending mode." }, "trendingConcurrency": { "title": "Trending Concurrency", "minimum": 1, "maximum": 15, "type": "integer", "description": "Parallel HTTP fetches in trending mode. Higher = faster + cheaper compute. Default 8, max 15.", "default": 8 }, "exploreConcurrency": { "title": "Explore Concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Parallel Playwright pages in explore mode. Higher = faster but risk of rate limits. Default 3, max 5.", "default": 3 } } }, "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 } } } } } } } } } }