{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now Monitor - New Trend Alerts", "description": "Get an alert for every new Google Trends trending search in the countries you pick, with search volume, start time and news links. Only new trends are reported and charged. Webhook and Slack included.", "version": "0.1", "x-build-id": "n3qUf6fvx9AJ9qoTc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/skillmerc~google-trends-trending-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-skillmerc-google-trends-trending-monitor", "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/skillmerc~google-trends-trending-monitor/runs": { "post": { "operationId": "runs-sync-skillmerc-google-trends-trending-monitor", "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/skillmerc~google-trends-trending-monitor/run-sync": { "post": { "operationId": "run-sync-skillmerc-google-trends-trending-monitor", "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 as used by Google Trends, e.g. US, GB, ZA, IN, AU, DE, BR, CA, NG, KE.", "default": [ "US", "GB", "ZA", "IN", "AU" ], "items": { "type": "string" } }, "includeNews": { "title": "Include news articles", "type": "boolean", "description": "Attach the news articles Google lists for each trend (title, URL, source, image).", "default": true }, "reportCurrentOnFirstRun": { "title": "Report current trends on the first run", "type": "boolean", "description": "If on, the first run reports everything trending right now. If off, the first run only saves a baseline (no alerts, no alert charges) and later runs report new trends only.", "default": true }, "minTraffic": { "title": "Minimum search volume", "minimum": 0, "type": "integer", "description": "Only alert on trends whose approximate search volume is at least this number (Google shows ranges such as 200+, 2000+, 50K+). 0 means no filter.", "default": 0 }, "keywords": { "title": "Keywords (optional)", "type": "array", "description": "Only alert when the trend or one of its news headlines contains one of these words (case-insensitive). Leave empty to get every new trend.", "items": { "type": "string" } }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Name for this monitor. Its memory of already-reported trends lives in a key-value store named google-trends-monitor-. If empty, the name is derived from the countries, keywords and minimum volume, so changing those starts fresh." }, "rememberDays": { "title": "Remember trends for (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "A trend that has not appeared in the feed for this many days is forgotten, and would be reported again if it comes back.", "default": 7 }, "webhookUrl": { "title": "Webhook URL (optional)", "pattern": "^https?://.+", "type": "string", "description": "HTTPS endpoint that receives one POST per run (only when there are new trends) with the run summary and the alerts as JSON. Works with Make, Zapier and n8n webhooks." }, "slackWebhookUrl": { "title": "Slack incoming webhook URL (optional)", "pattern": "^https://hooks\\.slack\\.com/.+", "type": "string", "description": "One Slack message per run listing the new trends." }, "maxAlertsPerRun": { "title": "Max alerts per run", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap on alert rows delivered (and charged) in one run.", "default": 500 } } }, "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 } } } } } } } } } }