{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper: Trending Searches & Queries", "description": "Google Trends data and API: the trending searches of any country, interest over time and by region, and related and rising queries, for any time range, category and search type. Compare up to 5 terms on one scale, or paste a Google Trends link.", "version": "0.1", "x-build-id": "I2xSR0ShARi26Rr47" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kaleidoscopelabs~google-trends-dataset/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kaleidoscopelabs-google-trends-dataset", "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/kaleidoscopelabs~google-trends-dataset/runs": { "post": { "operationId": "runs-sync-kaleidoscopelabs-google-trends-dataset", "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/kaleidoscopelabs~google-trends-dataset/run-sync": { "post": { "operationId": "run-sync-kaleidoscopelabs-google-trends-dataset", "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": { "queries": { "title": "Search terms", "type": "array", "description": "One line per search: a term; up to 5 terms separated by commas, compared on one scale; or a Google Trends explore link (its region, time range, category and search type are kept for that line). A line that is none of these is skipped and said in the log. Leave it empty to read trending searches only.", "items": { "type": "string" } }, "interestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Each term's interest over the time range, 0–100.", "default": true }, "interestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Each term's interest per region of the chosen region: countries worldwide, subdivisions in a country.", "default": true }, "relatedQueries": { "title": "Related queries", "type": "boolean", "description": "The searches made with each term: the top ones and the rising ones.", "default": true }, "geo": { "title": "Region", "pattern": "^$|^[A-Za-z]{2}(-[A-Za-z0-9]{1,3}){0,2}$|^[Ww]orldwide$", "type": "string", "description": "Worldwide, or a country's two-letter code such as US or DE, or a region's code such as US-CA. A Google Trends link's own region is kept for its line.", "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": "The period to read, as Google Trends' time picker names it.", "default": "today 12-m" }, "customRange": { "title": "Custom time range", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2} \\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Two dates, from and to, in place of the time range: 2025-01-01 2025-06-30. From 2004 to today." }, "category": { "title": "Category", "enum": [ "0", "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, as on the site: all, or one of its top-level categories. For a sub-category, paste a Google Trends link with its own category.", "default": "0" }, "property": { "title": "Search type", "enum": [ "web", "youtube", "news", "images", "shopping" ], "type": "string", "description": "Which of Google's searches: web, YouTube, news, images or shopping.", "default": "web" }, "trendingGeos": { "title": "Trending now: countries", "maxItems": 50, "type": "array", "description": "Countries whose Google Trends trending searches (the Trending now list) to read, by two-letter code such as US, GB or DE. Leave it empty to read none.", "default": [], "items": { "type": "string" } }, "trendingHours": { "title": "Trending now: window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "How far back: the past 4 hours, 24 hours, 48 hours or 7 days, as Google Trends offers.", "default": "24" }, "trendingCategories": { "title": "Trending now: categories", "type": "array", "description": "Only the trending searches of these categories; leave it 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" ] }, "default": [] }, "trendingActiveOnly": { "title": "Trending now: active only", "type": "boolean", "description": "Only the searches still trending, not those that have ended within the window.", "default": false }, "monitorName": { "title": "Trending now: monitor name", "type": "string", "description": "Name a monitor, such as uk-sports-daily, and run it on a schedule: each run stores only the trending searches its earlier runs had not listed. $0.002 per country checked a run, plus the new searches." } } }, "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 } } } } } } } } } }