{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now Monitor - Full List & New Alerts", "description": "Get every Google Trends 'Trending Now' search for any country (hundreds, not just the top 10): search volume, % increase, start/end time, categories, related queries and news. Filter by category or volume, and schedule it in 'only new' mode to get just the trends that appeared since the last run.", "version": "0.1", "x-build-id": "88QfeKU0rew9opqHj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zahidthani~google-trends-trending-now/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zahidthani-google-trends-trending-now", "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/zahidthani~google-trends-trending-now/runs": { "post": { "operationId": "runs-sync-zahidthani-google-trends-trending-now", "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/zahidthani~google-trends-trending-now/run-sync": { "post": { "operationId": "run-sync-zahidthani-google-trends-trending-now", "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": [ "countries" ], "properties": { "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes to monitor (US, GB, DE, IN, BR, JP...). Each country is fetched separately; about 125 countries are supported by Google Trends.", "default": [ "US" ], "items": { "type": "string" } }, "timeWindow": { "title": "Time window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Which trends to include, by when they started. Same choices as the 'Since' filter on trends.google.com/trending.", "default": "24" }, "categories": { "title": "Categories (optional)", "type": "array", "description": "Only return trends in these Google Trends categories (e.g. Sports, Technology, Business and Finance). Leave empty for all categories.", "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" ] } }, "minSearchVolume": { "title": "Minimum search volume", "minimum": 0, "type": "integer", "description": "Skip trends with fewer searches than this (Google's estimate, e.g. 2000, 10000, 100000). 0 keeps everything.", "default": 0 }, "activeOnly": { "title": "Active trends only", "type": "boolean", "description": "Only return trends that are still rising right now (Google marks the rest as ended).", "default": false }, "keywordFilter": { "title": "Keyword filter (optional)", "type": "string", "description": "Only return trends whose search or related searches contain this text, e.g. 'iphone' or 'election'. Case-insensitive." }, "sortBy": { "title": "Sort by", "enum": [ "rank", "volume", "newest" ], "type": "string", "description": "Order of results within each country. Applied before the per-country limit, so 'Search volume' + a limit of 20 gives the 20 biggest trends.", "default": "rank" }, "maxItemsPerCountry": { "title": "Max trends per country", "minimum": 0, "type": "integer", "description": "Stop after this many trends per country (after filters). 0 = no limit (a busy country has 300-500 trends per day). You pay per trend delivered.", "default": 25 }, "onlyNew": { "title": "Only new trends (monitor mode)", "type": "boolean", "description": "Remember what earlier runs returned and deliver only trends that weren't delivered before. Perfect for a schedule (e.g. every hour) feeding Slack, email or a sheet. Already-seen trends are not charged.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Used with 'Only new trends'. Each name keeps its own memory, so you can run separate monitors (e.g. 'us-tech' and 'uk-sports') without them hiding each other's trends.", "default": "default" }, "includeNews": { "title": "Include news links", "type": "boolean", "description": "Attach news articles (title, URL, source) and a picture to trends that Google's news feed covers (usually the freshest top trends). Costs nothing extra.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Interface language used for the request, e.g. en-US, de, fr, ja. Trend titles stay in the language people searched in.", "default": "en-US" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is recommended. Datacenter proxies are used first; the Actor rotates IPs automatically when Google slows down.", "default": { "useApifyProxy": true } }, "allowResidentialFallback": { "title": "Residential proxy fallback", "type": "boolean", "description": "If Google keeps refusing requests from datacenter IPs, switch to residential proxies (when your plan includes them) so the run still succeeds.", "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 } } } } } } } } } }