{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper — Interest, Regions, Queries & Topics", "description": "Google Trends interest over time, interest by region and top/rising related queries and topics for any keyword, from the site's own JSON API — no browser. Warms the session cookie and rotates IPs on HTTP 429, so runs finish instead of timing out.", "version": "1.0", "x-build-id": "pTvwQV4QfFKiHEL7i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/diopside~google-trends/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-diopside-google-trends", "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/diopside~google-trends/runs": { "post": { "operationId": "runs-sync-diopside-google-trends", "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/diopside~google-trends/run-sync": { "post": { "operationId": "run-sync-diopside-google-trends", "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 or topics to look up on Google Trends, e.g. bitcoin, electric car. One set of results per term (or one comparison per group of five, when 'Compare terms' is on).", "items": { "type": "string" } }, "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": "How far back to look. Uses Google's own range codes, so the numbers match what trends.google.com shows — and the same codes other Google Trends actors accept, including the empty default.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Overrides 'Time range' when set. Two dates separated by a space: 2024-01-01 2024-12-31.", "default": "" }, "geo": { "title": "Location", "type": "string", "description": "ISO country code (US, GB, DE), a subregion (US-NY, AU-NSW) or a metro (US-NY-501). Leave empty for worldwide.", "default": "" }, "searchType": { "title": "Search type", "enum": [ "Web Search", "Image Search", "News Search", "Google Shopping", "YouTube Search" ], "type": "string", "description": "Which Google surface the interest is measured on.", "default": "Web Search" }, "category": { "title": "Category", "enum": [ "", "3", "47", "44", "22", "12", "5", "7", "71", "8", "45", "65", "11", "13", "958", "19", "16", "299", "14", "66", "29", "533", "174", "18", "20", "67" ], "type": "string", "description": "Google Trends category to narrow the query to. Same values other Google Trends actors use, so an existing input carries over unchanged. Use 'Category ID' below for a category that is not in this list.", "default": "" }, "categoryId": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Any Google Trends category ID, including the ~1400 sub-categories the list above does not show (e.g. 1138 Cryptocurrency). Overrides 'Category' when not 0.", "default": 0 }, "outputs": { "title": "Data to collect", "type": "array", "description": "Which Google Trends panels to export. Each produces its own record type in the dataset. You are billed per search term, not per record, so asking for every panel costs the same as asking for one.", "items": { "type": "string", "enum": [ "interestOverTime", "interestByRegion", "relatedQueries", "relatedTopics" ], "enumTitles": [ "Interest over time", "Interest by region", "Related queries (top & rising)", "Related topics (top & rising)" ] }, "default": [ "interestOverTime", "interestByRegion", "relatedQueries", "relatedTopics" ] }, "geoResolution": { "title": "Region detail", "enum": [ "", "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Granularity of 'Interest by region'. Auto follows what Google shows for the location (countries worldwide, states for a country). CITY and DMA only return data for a single-country location.", "default": "" }, "isMultiple": { "title": "Compare terms", "type": "boolean", "description": "Off (default): every term is scored 0-100 on its own scale. On: terms are compared against each other in groups of five, exactly like the compare view on trends.google.com.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Google interface language, e.g. en-US, de, fr. Affects region names and formatted labels only.", "default": "en-US" }, "maxItems": { "title": "Max records", "minimum": 0, "type": "integer", "description": "Hard cap on dataset records. 0 = no cap. Cost is per search term, so this caps dataset size rather than price — a term is billed once, the first time it returns a record.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google Trends rate-limits by IP. This is the proxy tried first; when a tier runs out of budget the actor rotates the IP by itself and finally escalates to Apify RESIDENTIAL — see 'Residential fallback'.", "default": { "useApifyProxy": true } }, "residentialFallback": { "title": "Residential fallback", "type": "boolean", "description": "When the proxy above keeps getting HTTP 429 from Google, automatically retry on Apify RESIDENTIAL proxies (country US). Residential traffic is billed by the GB on your account; turn this off to keep a run strictly on the proxy you chose.", "default": 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 }, "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 } } } } } } } } } }