{ "openapi": "3.0.1", "info": { "title": "Google Trends API - Interest Over Time, Regions & Queries ✅", "description": "Google Trends API: interest over time, regions, related queries and topics for any keyword, plus a summary row. Compare up to 5 keywords on one scale. No browser, no captchas. Web, News, YouTube, Images, Shopping. A Google Trends scraper with free no-data keywords. CSV, Excel, JSON, API.", "version": "0.0", "x-build-id": "dgedU57qgt5Nnj6Az" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unseenuser~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unseenuser-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/unseenuser~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-unseenuser-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/unseenuser~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-unseenuser-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", "properties": { "keywords": { "title": "Keywords (one report each)", "maxItems": 200, "type": "array", "description": "Each keyword gets its own full report on its own 0-100 scale: summary, interest over time, regions, related queries and related topics. Free Apify plan: up to 5 results per run; paid plans: no limit.", "items": { "type": "string" } }, "compareKeywords": { "title": "Compare keywords (2-5, one shared scale)", "minItems": 0, "maxItems": 5, "type": "array", "description": "Compare 2 to 5 keywords on one shared 0-100 scale: interest over time and regions for each. Related queries and topics are not part of comparisons.", "items": { "type": "string" } }, "searchType": { "title": "Search type", "enum": [ "web", "news", "youtube", "images", "shopping" ], "type": "string", "description": "Which Google search the trend comes from.", "default": "web" }, "country": { "title": "Country", "enum": [ "Worldwide", "United States", "United Kingdom", "Canada", "Australia", "India", "Germany", "France", "Spain", "Italy", "Netherlands", "Belgium", "Sweden", "Norway", "Denmark", "Finland", "Poland", "Ireland", "Portugal", "Austria", "Switzerland", "Czechia", "Romania", "Greece", "Turkey", "Israel", "United Arab Emirates", "Saudi Arabia", "Egypt", "South Africa", "Nigeria", "Kenya", "Brazil", "Mexico", "Argentina", "Colombia", "Chile", "Peru", "Japan", "South Korea", "Taiwan", "Hong Kong", "Singapore", "Malaysia", "Indonesia", "Philippines", "Thailand", "Vietnam", "New Zealand", "Pakistan", "Ukraine" ], "type": "string", "description": "Worldwide, or one country. With a country, interest by region is broken down into its states or regions.", "default": "Worldwide" }, "timeRange": { "title": "Time range", "enum": [ "past_hour", "past_4_hours", "past_day", "past_7_days", "past_30_days", "past_90_days", "past_12_months", "past_5_years", "all_time" ], "type": "string", "description": "The period to look at. All time starts in 2004 for web search and in 2008 for the other search types.", "default": "past_12_months" }, "dataSets": { "title": "Data sets in keyword reports", "type": "array", "description": "Which data sets to include in keyword reports. Every report also starts with a summary row.", "items": { "type": "string", "enum": [ "interest_over_time", "regions", "related_queries", "related_topics" ], "enumTitles": [ "Interest over time", "Interest by region", "Related queries", "Related topics" ] }, "default": [ "interest_over_time", "regions", "related_queries", "related_topics" ] } } }, "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 } } } } } } } } } }