{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper — interest over time, regions, related", "description": "Google Trends data that always finishes. Interest over time, interest by region and related queries, with Top and Rising labelled separately. Hard run limit, session-aware retries and partial-result flushing — no infinite loops, no empty runs. Any keyword, country and timeframe.", "version": "0.1", "x-build-id": "Oh50Ax4vMfiJzdwJc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crearcode~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crearcode-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/crearcode~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-crearcode-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/crearcode~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-crearcode-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": [ "keywords" ], "properties": { "keywords": { "title": "Search terms", "type": "array", "description": "One or more search terms. By default each term is fetched independently, so every term gets its own 0-100 scale.", "items": { "type": "string" } }, "compareKeywords": { "title": "Compare terms against each other", "type": "boolean", "description": "Off (default): each term is scored on its own scale — use this to see each term's own trend. On: terms are scored against each other on one shared scale, in groups of five, exactly like the Compare view on the Trends website. These answer different questions and the numbers are not interchangeable.", "default": false }, "geo": { "title": "Location", "type": "string", "description": "ISO-3166 country code such as US, CO, MX, ES. Sub-regions work too, e.g. US-CA. Leave empty for worldwide." }, "timeframe": { "title": "Time range", "type": "string", "description": "Google timeframe string. Common values: \"now 1-H\", \"now 7-d\", \"today 1-m\", \"today 3-m\", \"today 12-m\", \"today 5-y\", \"all\". A custom range works as \"2025-01-01 2026-01-01\".", "default": "today 12-m" }, "property": { "title": "Search property", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Which Google surface to measure.", "default": "" }, "category": { "title": "Category", "minimum": 0, "type": "integer", "description": "Google Trends category id. 0 means all categories.", "default": 0 }, "includeInterestOverTime": { "title": "Interest over time", "type": "boolean", "description": "The 0-100 popularity series over the selected time range. This is the core Google Trends chart.", "default": true }, "includeInterestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Relative popularity broken down by country, or by sub-region when a country is set in Location.", "default": true }, "includeRelatedQueries": { "title": "Related queries", "type": "boolean", "description": "Returns both Google's Top and Rising lists, labelled — Rising is where breakouts show up.", "default": true }, "includeRelatedTopics": { "title": "Related topics", "type": "boolean", "description": "Off by default: Google returns nothing here for lower-volume terms.", "default": false }, "maxRunSeconds": { "title": "Hard run limit (seconds)", "minimum": 30, "type": "integer", "description": "The run stops cleanly at this point and keeps everything already collected. This is what stops a run from hanging: no retry, wait or request can ever push past it.", "default": 300 }, "requestTimeoutSeconds": { "title": "Per-request timeout (seconds)", "minimum": 5, "type": "integer", "description": "How long a single request to Google may take before it is abandoned and retried. Keep it well below the hard run limit.", "default": 20 }, "paceMs": { "title": "Delay between requests (ms)", "minimum": 0, "type": "integer", "description": "Politeness pacing. 800ms is comfortable; lower it if you are in a hurry and accept more re-handshakes.", "default": 800 }, "language": { "title": "Language", "type": "string", "description": "Affects Google's labels and the related-terms language.", "default": "en-US" } } }, "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 } } } } } } } } } }