{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now Scraper — Searches by Country", "description": "Get Google Trends Trending Now searches: title, search volume, growth %, start and end time, categories, related queries and news articles. Many countries and subregions per run, 1–168 h window, no login. $0.85 per 1,000 trends.", "version": "0.0", "x-build-id": "YW7kYrR6ziFPWLdmz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/genial_candlestand~google-trending-now-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-genial_candlestand-google-trending-now-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/genial_candlestand~google-trending-now-scraper/runs": { "post": { "operationId": "runs-sync-genial_candlestand-google-trending-now-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/genial_candlestand~google-trending-now-scraper/run-sync": { "post": { "operationId": "run-sync-genial_candlestand-google-trending-now-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": { "geos": { "title": "Countries or subregions", "type": "array", "description": "One code per line: a country code (US, DE, JP) or a subregion (US-CA, GB-SCT). About 125 countries are supported; Worldwide is not available on Trending Now. Lower case is accepted and UK is read as GB. Unsupported codes are skipped with a warning.", "default": [ "US" ], "items": { "type": "string" } }, "hours": { "title": "Time window (hours)", "minimum": 1, "maximum": 168, "type": "integer", "description": "Trends started in the past N hours: 4, 24, 48 or 168 (7 days) as on the website, or any whole number from 1 to 168. The window always ends now.", "default": 24 }, "maxItemsPerGeo": { "title": "Max trends per geo", "minimum": 1, "maximum": 5000, "type": "integer", "description": "At most this many trends per country or subregion, after filters and sorting (e.g. the top 25 by search volume).", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "searchVolume", "recency", "title" ], "type": "string", "description": "Order of the trends of each geo before the per-geo limit is applied. Relevance is Google's default order on the website.", "default": "relevance" }, "categories": { "title": "Categories", "type": "array", "description": "Keep only trends in any of these categories (a trend can have several). Empty = all categories. Works for every geo and time window.", "items": { "type": "string", "enum": [ "sports", "entertainment", "politics", "business", "technology", "games", "health", "science", "law", "jobs", "autos", "beauty", "food", "hobbies", "pets", "shopping", "travel", "climate", "other" ], "enumTitles": [ "Sports", "Entertainment", "Politics", "Business and Finance", "Technology", "Games", "Health", "Science", "Law and Government", "Jobs and Education", "Autos and Vehicles", "Beauty and Fashion", "Food and Drink", "Hobbies and Leisure", "Pets and Animals", "Shopping", "Travel and Transportation", "Climate", "Other" ] }, "default": [] }, "status": { "title": "Trend status", "enum": [ "all", "active", "ended" ], "type": "string", "description": "All trends, only trends that are still active (searches still rising), or only trends that have ended.", "default": "all" }, "minSearchVolume": { "title": "Min search volume", "minimum": 0, "type": "integer", "description": "Keep only trends with at least this search volume (Google's lower bound, e.g. 10000 keeps 10K+ and more). 0 = no minimum.", "default": 0 }, "includeNews": { "title": "Include news articles", "type": "boolean", "description": "Add the news articles Google links to each trend (title, URL, source, time, image). Turn off for faster runs; News articles per trend is then ignored.", "default": true }, "newsPerTrend": { "title": "News articles per trend", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many news articles to fetch per trend, 1–30 (Google returns fewer when a trend has fewer). Only used with Include news articles.", "default": 3 }, "onlyNew": { "title": "Only new trends", "type": "boolean", "description": "For scheduled alerts: return only trends not returned by earlier runs with the same Only-new memory name (same geo, title and start time). The first run returns everything. Skipped trends are free.", "default": false }, "onlyNewKey": { "title": "Only-new memory name", "pattern": "^[a-zA-Z0-9_-]{1,60}$", "type": "string", "description": "Name of the memory of already returned trends, used only with Only new trends. Give each schedule its own name (letters, digits, - and _), e.g. us-sports-alerts.", "default": "default" }, "maxItems": { "title": "Max results in total", "minimum": 1, "type": "integer", "description": "Stop after this many rows across all geos. Empty = no total limit (only Max trends per geo applies)." }, "language": { "title": "Language", "pattern": "^[a-z]{2,3}(-[A-Za-z]{2,4})?$", "type": "string", "description": "Interface language code sent to Google (hl), e.g. en-US, de, ja. It does not translate trend titles (they are what people searched) and news follows the geo; category names are always English.", "default": "en-US" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy settings. Apify datacenter proxy (default) works; no blocking was observed.", "default": { "useApifyProxy": 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 } } } } } } } } } }