{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper: drop-in input, no browser", "description": "Google Trends per search term: interest over time, by subregion and city, and related queries. Takes the same input fields as Apify's Google Trends Scraper and returns the same row shape, so switching means changing only the actor ID. No browser, so no page timeouts. Pay per term.", "version": "0.1", "x-build-id": "4fjaZjDwhAtGLLlkD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadydata~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadydata-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/steadydata~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-steadydata-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/steadydata~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-steadydata-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "One row per search term. With 'Compare terms' switched on, a comma-separated entry such as 'tea, coffee' is compared in one chart. Max 200 per run.", "items": { "type": "string" } }, "isMultiple": { "title": "Compare terms", "type": "boolean", "description": "Treat a comma-separated entry as up to five terms compared in one chart, like the comparison on the Google Trends site.", "default": false }, "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 of the interest-over-time series. Empty means the past 12 months.", "default": "" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Overrides the time range. Format 'YYYY-MM-DD YYYY-MM-DD', for example '2024-01-01 2024-12-31'." }, "geo": { "title": "Country or region", "type": "string", "description": "Two-letter country code such as US, NL or DE, or a region code such as US-CA. Empty for worldwide. Inside a country you also get interest by subregion and by city.", "default": "" }, "category": { "title": "Category", "type": "string", "description": "Google Trends category ID, for example 3 for Arts & Entertainment or 47 for Autos & Vehicles. Empty for all categories.", "default": "" }, "viewedFrom": { "title": "Language of labels", "type": "string", "description": "Language code for Google's formatted labels, for example en-US or de. Empty for English.", "default": "" }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Paste explore URLs from trends.google.com; the term, country, period and category are read from the URL.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max rows", "minimum": 0, "type": "integer", "description": "Stop after this many search terms and URLs together. 0 means no limit (max 200 per run).", "default": 0 }, "spreadsheetId": { "title": "Spreadsheet ID (not used)", "type": "string", "description": "Accepted for compatibility and ignored: paste the terms into 'Search terms' instead." }, "skipDebugScreen": { "title": "Skip debug screen (not used)", "type": "boolean", "description": "Accepted for compatibility; this actor uses no browser." }, "maxConcurrency": { "title": "Max concurrency (not used)", "type": "integer", "description": "Accepted for compatibility; concurrency is managed by the actor." }, "maxRequestRetries": { "title": "Max request retries (not used)", "type": "integer", "description": "Accepted for compatibility; every term gets three proxy sessions." }, "pageLoadTimeoutSecs": { "title": "Page load timeout (not used)", "type": "integer", "description": "Accepted for compatibility; this actor loads no pages." } } }, "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 } } } } } } } } } }