{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Google Trends data without the 429 errors: interest over time, interest by region, related queries and related topics for up to 5 compared terms, any country, time range, category or Google property (Web, YouTube, News, Images, Shopping).", "version": "0.2", "x-build-id": "FbvWDm9Sb6lWRPvBq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/potato_44~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-potato_44-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/potato_44~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-potato_44-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/potato_44~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-potato_44-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": "Explore mode. One query per line. To compare terms on the same scale (like the Trends website), put up to 5 on one line separated by commas, e.g. \"bitcoin, ethereum\". Can be left empty if you only want Trending now.", "items": { "type": "string" } }, "geo": { "title": "Country / region", "type": "string", "description": "Two-letter country code (US, AU, GB...) or region code (US-CA, AU-NSW). Leave empty for worldwide.", "default": "" }, "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": "Preset range, or a custom one as \"YYYY-MM-DD YYYY-MM-DD\" in the field below.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "pattern": "^(\\d{4}-\\d{2}-\\d{2} \\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Overrides Time range. Format: \"2024-01-01 2024-06-30\"." }, "category": { "title": "Category ID", "type": "integer", "description": "Google Trends category ID (0 = all categories).", "default": 0 }, "gprop": { "title": "Google property", "enum": [ "", "youtube", "news", "images", "froogle" ], "type": "string", "description": "Which Google search to measure: Web (default), YouTube, News, Images or Shopping.", "default": "" }, "interestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Search interest timeline (0-100) for each term.", "default": true }, "interestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Breakdown by state/province of the selected country, or by country when worldwide.", "default": true }, "interestByCity": { "title": "Interest by city", "type": "boolean", "description": "City-level breakdown with coordinates (needs a country in 'Country / region'). Adds one extra Google request per line.", "default": false }, "interestByMetro": { "title": "Interest by metro area (US only)", "type": "boolean", "description": "US Nielsen DMA metro breakdown. Adds one extra Google request per line.", "default": false }, "relatedQueries": { "title": "Related queries (top + rising)", "type": "boolean", "description": "Top and rising related search queries for each term.", "default": true }, "relatedTopics": { "title": "Related topics (top + rising)", "type": "boolean", "description": "Google only provides related topics when a line has a single term.", "default": true }, "trendingCountries": { "title": "Countries", "type": "array", "description": "Two-letter country codes, e.g. US, AU, GB. Leave empty to skip Trending now.", "items": { "type": "string" } }, "trendingHours": { "title": "Time window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "How far back to look for trending searches.", "default": "24" }, "trendingCategories": { "title": "Categories", "type": "array", "description": "Only keep trends in these categories. Leave empty for all.", "items": { "type": "string", "enum": [ "Autos and Vehicles", "Beauty and Fashion", "Business and Finance", "Climate", "Entertainment", "Food and Drink", "Games", "Health", "Hobbies and Leisure", "Jobs and Education", "Law and Government", "Other", "Pets and Animals", "Politics", "Science", "Shopping", "Sports", "Technology", "Travel and Transportation" ] } }, "trendingActiveOnly": { "title": "Still trending only", "type": "boolean", "description": "Skip searches that have stopped trending.", "default": false }, "maxTrendingPerCountry": { "title": "Max trends per country", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Highest search volume first.", "default": 100 } } }, "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 } } } } } } } } } }