{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper (Fast, No Browser)", "description": "Interest over time, interest by region and related queries from Google Trends for any search term or comparison of up to 5 terms. Direct API calls instead of a browser: fast, cheap and patient with rate limits. You pay only for results delivered.", "version": "0.1", "x-build-id": "mKHwJq7ZZ5QKQJkdX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fabricalabs~google-trends-fast/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fabricalabs-google-trends-fast", "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/fabricalabs~google-trends-fast/runs": { "post": { "operationId": "runs-sync-fabricalabs-google-trends-fast", "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/fabricalabs~google-trends-fast/run-sync": { "post": { "operationId": "run-sync-fabricalabs-google-trends-fast", "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 search term per line. Each line becomes one result. To compare terms on the same chart, put them on one line separated by commas and turn on 'Compare terms on the same line'.", "items": { "type": "string" } }, "isMultiple": { "title": "Compare terms on the same line", "type": "boolean", "description": "When on, commas separate up to 5 terms that are compared against each other, exactly like the Compare box on the Google Trends website.", "default": false }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Optional. Paste Google Trends explore URLs (trends.google.com/trends/explore?...) to reuse the terms and filters you set up in the browser.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "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 to analyse. Ignored when a custom time range is set.", "default": "" }, "customTimeRange": { "title": "Custom time range", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2} \\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional. Start and end date separated by a space, e.g. 2024-01-01 2024-06-30. Overrides the time range above." }, "geo": { "title": "Country or region", "type": "string", "description": "Two-letter country code (US, ES, BR, DE...) or a region code such as US-CA. Leave empty for worldwide.", "default": "" }, "category": { "title": "Category", "pattern": "^\\d*$", "type": "string", "description": "Google Trends category id, e.g. 47 for Autos & Vehicles. It appears as cat= in Google Trends URLs. Leave empty for all categories.", "default": "" }, "searchProperty": { "title": "Search type", "enum": [ "web", "images", "news", "shopping", "youtube" ], "type": "string", "description": "Which Google search the interest comes from.", "default": "web" }, "includeInterestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Popularity from 0 to 100 for each period of the time range.", "default": true }, "includeInterestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Popularity per country, or per subregion when a country is selected. For comparisons, each term's share in each region.", "default": true }, "includeRelatedQueries": { "title": "Related queries", "type": "boolean", "description": "Top and rising searches related to each term.", "default": true }, "includeRelatedTopics": { "title": "Related topics", "type": "boolean", "description": "Top and rising topics for single terms. Google does not provide topics for comparisons and sometimes withholds them; the list is empty then.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Language of topic names and dates, e.g. en-US, es, pt-BR.", "default": "en-US" }, "maxItems": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Stop after this many search terms or comparisons. 0 means no limit.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google Trends limits how often one IP can ask. The default residential proxy keeps runs reliable." } } }, "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 } } } } } } } } } }