{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper - Reliable, Pay Only for Results", "description": "Google Trends interest over time, related queries (top and rising), interest by region and related topics for many keywords and countries. Hard time limit per keyword, automatic retry on rate limits, and you are not charged when Google returns nothing.", "version": "0.1", "x-build-id": "Tg0ug10AYCbZrUSMd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/myceworks~google-trends-reliable/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-myceworks-google-trends-reliable", "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/myceworks~google-trends-reliable/runs": { "post": { "operationId": "runs-sync-myceworks-google-trends-reliable", "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/myceworks~google-trends-reliable/run-sync": { "post": { "operationId": "run-sync-myceworks-google-trends-reliable", "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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to look up. Each term is fetched on its own (no cross-term normalisation), so values are comparable over time and across regions for the same term.", "default": [ "air fryer" ], "items": { "type": "string" } }, "geos": { "title": "Locations", "type": "array", "description": "ISO country codes (US, GB, DE, JP, KR …) or sub-regions (US-CA). Leave one empty line for worldwide. One result per term × location.", "default": [ "US" ], "items": { "type": "string" } }, "timeframe": { "title": "Time range", "type": "string", "description": "One of: 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 — or a custom range 'YYYY-MM-DD YYYY-MM-DD'.", "default": "today 12-m" }, "property": { "title": "Google property", "enum": [ "web", "youtube", "news", "images", "shopping" ], "type": "string", "description": "Which Google search to measure.", "default": "web" }, "category": { "title": "Category ID", "type": "integer", "description": "Google Trends category ID. 0 = all categories.", "default": 0 }, "interestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Weekly/daily interest (0-100) plus a summary: mean, max, first and last four points, change %.", "default": true }, "relatedQueries": { "title": "Related queries (top and rising)", "type": "boolean", "description": "Top and rising search queries related to the term. Rising values are % growth.", "default": true }, "interestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Sub-regions of the chosen location, sorted by interest.", "default": false }, "relatedTopics": { "title": "Related topics (top and rising)", "type": "boolean", "description": "Top and rising topics (entities) related to the term.", "default": false }, "maxSecondsPerTerm": { "title": "Time limit per result (seconds)", "minimum": 20, "maximum": 300, "type": "integer", "description": "Hard limit for one term × location, including retries after Google rate limits. When reached, that section is marked as failed and the run moves on — it never loops.", "default": 90 } } }, "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 } } } } } } } } } }