{ "openapi": "3.0.1", "info": { "title": "Search Trend Monitor — Google Trends, Interest & Related", "description": "Google Trends without the empty run. Interest over time, interest by region and related queries for your keywords. If Google returns nothing, the run says so and you are not charged — you pay per delivered row, never for the run. Flat JSON/CSV, no login, no quota.", "version": "0.2", "x-build-id": "oo07vnwddjrbWfwil" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eszetael_lab~search-trend-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eszetael_lab-search-trend-monitor", "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/eszetael_lab~search-trend-monitor/runs": { "post": { "operationId": "runs-sync-eszetael_lab-search-trend-monitor", "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/eszetael_lab~search-trend-monitor/run-sync": { "post": { "operationId": "run-sync-eszetael_lab-search-trend-monitor", "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": [ "keywords" ], "properties": { "mode": { "title": "Mode", "enum": [ "interest_over_time", "interest_by_region", "related_queries" ], "type": "string", "description": "What to scrape.", "default": "interest_over_time" }, "keywords": { "title": "Keywords", "maxItems": 200, "type": "array", "description": "Terms to analyze (max 200; extra are ignored). In interest_over_time / interest_by_region up to 5 keywords share one 0–100 scale per request; more are split into separate groups — see `chunkGroup` in the output, values are only comparable WITHIN the same group. In related_queries each keyword is queried on its own.", "items": { "type": "string" } }, "timeframe": { "title": "Timeframe", "type": "string", "description": "Google Trends time range, e.g. 'today 12-m', 'today 5-y', 'now 7-d', or 'YYYY-MM-DD YYYY-MM-DD'.", "default": "today 12-m" }, "geo": { "title": "Geo", "type": "string", "description": "Two-letter country code (e.g. US, PL) or empty for worldwide.", "default": "" }, "category": { "title": "Category", "type": "integer", "description": "Google Trends category id (0 = all categories).", "default": 0 }, "maxItems": { "title": "Max results", "type": "integer", "description": "Cap on delivered records (0 = up to the safety limit of 50000). This is your cost ceiling as well as your time ceiling: you pay per delivered record, and every extra batch is another request to Google, which throttles hard once you ask too fast. The default of 10000 is high — set it to what you actually need.", "default": 10000 }, "onlyNew": { "title": "Only new", "type": "boolean", "description": "Emit only records not seen in previous runs with the same input (monitoring/alerts).", "default": false }, "stateKey": { "title": "State key (onlyNew)", "type": "string", "description": "Optional explicit key for the onlyNew memory store. Leave empty to derive from the input." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google Trends blocks datacenter IPs (HTTP 429). A RESIDENTIAL Apify proxy is strongly recommended — without it most runs will be rate-limited.", "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 } } }, "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 } } } } } } } } } }