{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper: Interest Over Time & Rising Queries", "description": "Google Trends data for any keywords: interest over time, interest by region, related queries (top and rising) and trending now searches by country. Compare up to five keywords; any country, date range, category and search type. Plain HTTP, no browser. Results also as ready-made spreadsheets.", "version": "0.1", "x-build-id": "tQB40bNvR4mZFEviD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/charitable_trousseau~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-charitable_trousseau-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/charitable_trousseau~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-charitable_trousseau-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/charitable_trousseau~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-charitable_trousseau-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "One term per line, for example air fryer. Each term gives one result per location. To compare terms in one chart, write them on one line separated by commas and switch on the option below. If no search term, Google Trends URL or Trending now country is given, the example search air fryer runs (in the US unless a location is set).", "items": { "type": "string" } }, "isMultiple": { "title": "Compare terms written on one line", "type": "boolean", "description": "When on, a line such as \"tea, coffee, matcha\" becomes one chart comparing up to five terms, scaled against each other as on Google Trends. When off, commas are part of the term.", "default": false }, "geo": { "title": "Location", "type": "string", "description": "Two-letter country code such as US, GB or DE, or a region code such as US-CA. Several codes separated by commas give one result per term and location. Leave empty for worldwide." }, "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": "Past 12 months when left on default. Shorter ranges give finer steps: hourly for 7 days, daily for 30 and 90 days, weekly for 12 months and 5 years, monthly for 2004 to present.", "default": "" }, "customTimeRange": { "title": "Custom dates", "type": "string", "description": "Optional. Two dates as YYYY-MM-DD YYYY-MM-DD, for example 2024-01-01 2024-06-30. Overrides the time range above. Data starts in 2004." }, "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": "Limits the term to searches in one Google Trends category.", "default": "" }, "property": { "title": "Search type", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Which Google search the interest is measured on.", "default": "" }, "outputs": { "title": "Data to collect", "type": "array", "description": "Leave empty for interest over time, interest by region, related queries and related topics. City lists must be chosen here: for a whole country Google often refuses them or returns only a handful of cities, and they slow the run down.", "items": { "type": "string", "enum": [ "interestOverTime", "interestByRegion", "interestByCity", "relatedQueries", "relatedTopics" ], "enumTitles": [ "Interest over time", "Interest by region", "Interest by city", "Related queries (top and rising)", "Related topics (top and rising)" ] } }, "trendingNowCountries": { "title": "Trending now: countries", "type": "string", "description": "Optional. Two-letter country codes separated by commas, for example US, GB. Adds one result per country with the searches trending there right now." }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Optional. Paste the address of any chart from trends.google.com/trends/explore. Terms, location, dates, category and search type are read from the address, including a different location or date range per term.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Stop after this many results. 0 means no limit.", "default": 0 }, "maxConcurrency": { "title": "Searches at the same time", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many searches run in parallel.", "default": 8 } } }, "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 } } } } } } } } } }