{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Fast Google Trends scraper. Get interest over time, interest by subregion, and top and rising related queries and topics for any keyword, in any country, over any time range. Reads Google's own widget JSON API directly, no headless browser and no API key. Flat CSV-ready output.", "version": "0.1", "x-build-id": "McMOD8KRvAjLZHw1p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cirkit~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cirkit-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/cirkit~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-cirkit-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/cirkit~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-cirkit-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": "Keywords", "type": "array", "description": "Search terms to analyse, one per line. Each keyword is scraped independently unless 'Compare keywords' is on.", "default": [ "air fryer" ], "items": { "type": "string" } }, "geo": { "title": "Location", "type": "string", "description": "Two-letter country code such as US, GB or DE. Add a subregion for state or province level, e.g. US-CA. Clear the field entirely for worldwide, which returns interest broken down by country.", "default": "US" }, "timeframe": { "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": "Preset window to chart. Ignored when 'Custom time range' is filled in. Shorter ranges return finer buckets: 'now 7-d' is hourly, 'today 12-m' is weekly.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Explicit window as 'YYYY-MM-DD YYYY-MM-DD', for example '2024-01-01 2024-12-31'. Overrides the preset time range when set." }, "dataTypes": { "title": "Data to scrape", "type": "array", "description": "Which datasets to pull for each keyword. Deselecting the ones you do not need makes runs faster and cheaper. Related topics is off by default because Google itself currently serves an empty topics widget - see the note in its label.", "items": { "type": "string", "enum": [ "interestOverTime", "interestBySubregion", "relatedQueries", "relatedTopics" ], "enumTitles": [ "Interest over time", "Interest by subregion", "Related queries (top and rising)", "Related topics - Google currently returns none, leave off" ] }, "default": [ "interestOverTime", "interestBySubregion", "relatedQueries" ] }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Hard cap on rows written to the dataset across all keywords. One keyword over 12 months in the US yields roughly 150 rows with every data type enabled.", "default": 1000 }, "compareKeywords": { "title": "Compare keywords against each other", "type": "boolean", "description": "Chart all keywords together so their values are normalised against each other, exactly like adding comparison terms on trends.google.com. Maximum 5 keywords. In this mode the subregion rows show each keyword's share of interest in that region rather than its own 0-100 index. Leave off to scrape each keyword independently.", "default": false }, "category": { "title": "Category", "minimum": 0, "type": "integer", "description": "Google Trends numeric category id to restrict the query, for example 71 (Food & Drink) or 7 (Finance). 0 means all categories.", "default": 0 }, "property": { "title": "Search property", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Which Google surface to measure. Web search is the default.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google Trends rate-limits per IP, so a proxy is required for anything beyond a couple of keywords. Apify datacenter proxy is enough - residential costs far more and measurably does not help here.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }