{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now — Search Volume, News & Alerts", "description": "Live Google Trends 'Trending Now' searches for any country or region: search volume, growth, start/end time, categories, related searches and news articles. Track several countries in one run, or get only new trends on a schedule. No browser, $1 per 1,000 trends, no start fee.", "version": "1.0", "x-build-id": "PC7Onl8faYddNnlB0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalbench~google-trending-now/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalbench-google-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/signalbench~google-trending-now/runs": { "post": { "operationId": "runs-sync-signalbench-google-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/signalbench~google-trending-now/run-sync": { "post": { "operationId": "run-sync-signalbench-google-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", "properties": { "geos": { "title": "Countries / regions", "type": "array", "description": "Two-letter country codes (US, GB, DE, IN, JP…) or sub-regions (US-CA, GB-ENG). One row each; every one is fetched in the same run.", "items": { "type": "string" }, "default": [ "US" ] }, "timeWindow": { "title": "Time window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "How far back the Trending Now list goes. These are the four windows Google offers.", "default": "24" }, "categories": { "title": "Categories", "type": "array", "description": "Keep only trends in these categories. Leave empty for all categories.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "13", "14", "15", "16", "17", "18", "19", "20" ], "enumTitles": [ "Autos and Vehicles", "Beauty and Fashion", "Business and Finance", "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", "Climate" ] }, "default": [] }, "activeOnly": { "title": "Only trends that are still active", "type": "boolean", "description": "Skip trends Google marks as ended.", "default": false }, "minSearchVolume": { "title": "Minimum search volume", "minimum": 0, "type": "integer", "description": "Skip trends below this volume. Google reports volume in buckets (100+, 200+, 500+, 1K+, 2K+, 5K+, 10K+, 20K+, 50K+, 100K+, 200K+, 500K+, 1M+…), so use one of those.", "default": 0 }, "maxItemsPerGeo": { "title": "Max trends per country", "minimum": 0, "type": "integer", "description": "Cap on trends stored per country/region after filters and sorting. 0 = all of them (a large country has 300–500 per 24 hours). With 'Only new trends', this is the most alerts per run: trends past the cap are marked seen and skipped.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "searchVolume", "newest" ], "type": "string", "description": "Order of trends within each country. Applied before the per-country cap, so it decides which trends you keep.", "default": "relevance" }, "includeNews": { "title": "Include news articles", "type": "boolean", "description": "Add the news articles Google shows for each trend (title, URL, source, publish time, image). No extra charge; adds about a second per 8 trends.", "default": false }, "newsPerTrend": { "title": "Articles per trend", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many articles to attach to each trend (1–10).", "default": 3 }, "onlyNew": { "title": "Only new trends since the last run", "type": "boolean", "description": "For scheduled runs: skip trends this monitor already returned in an earlier run, so each run gives (and bills) only what is new. The list is kept in a named key-value store in your account (google-trending-now-seen). Don't run two schedules with the same Monitor ID at the same time.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Only used with 'Only new trends'. Give each scheduled task its own ID (e.g. us-sports) so tasks with different filters keep separate seen-lists.", "default": "default" }, "language": { "title": "Language", "type": "string", "description": "Language for Google's response, e.g. en-US, de, ja. Affects news and some labels; trend keywords are in the country's own language.", "default": "en-US" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave off: the Actor connects directly and switches to Apify residential proxies by itself if Google blocks it. Turn on to use a proxy from the first request.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }