{ "openapi": "3.0.1", "info": { "title": "Google Trending Now – Trends, Volume & News", "description": "All Google Trending Now searches – hundreds per country or US state, with search volume, growth, categories, related queries and news articles. Plus Google's Year in Search rankings.", "version": "0.1", "x-build-id": "R2zRIhhP0Bj3TiGkI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datarelay~google-trending-now/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datarelay-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/datarelay~google-trending-now/runs": { "post": { "operationId": "runs-sync-datarelay-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/datarelay~google-trending-now/run-sync": { "post": { "operationId": "run-sync-datarelay-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": { "mode": { "title": "Mode", "enum": [ "trendingNow", "yearInSearch" ], "type": "string", "description": "`trendingNow` – what is trending right now (default). `yearInSearch` – Google's yearly rankings (Year in Search).", "default": "trendingNow" }, "geos": { "title": "Locations", "type": "array", "description": "Country codes (`US`, `DE`, `PL`) or US states / regions (`US-CA`). For Year in Search: country codes (empty list = global).", "default": [ "US" ], "items": { "type": "string" } }, "hours": { "title": "Time window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Trends started within the last 4 hours, 24 hours, 48 hours or 7 days.", "default": "24" }, "categories": { "title": "Categories", "type": "array", "description": "Only trends in these categories (empty = all).", "items": { "type": "string", "enum": [ "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" ], "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": "Active trends only", "type": "boolean", "description": "Skip trends that already ended.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "searchVolume", "recency", "increase", "title" ], "type": "string", "description": "`relevance` keeps Google's order.", "default": "relevance" }, "maxTrends": { "title": "Max trends per location", "minimum": 0, "type": "integer", "description": "0 = all trends (often several hundred).", "default": 0 }, "includeArticles": { "title": "Include news articles", "type": "boolean", "description": "News articles explaining each trend (title, URL, source, time, image).", "default": true }, "maxArticlesPerTrend": { "title": "Max articles per trend", "minimum": 0, "maximum": 20, "type": "integer", "description": "Articles in the selected language are preferred.", "default": 3 }, "includeTrendTimeline": { "title": "Include interest over time", "type": "boolean", "description": "Adds a Google Trends chart for each trend (one extra Google request per trend, charged separately; proxies recommended).", "default": false }, "years": { "title": "Years (Year in Search)", "type": "array", "description": "For mode `yearInSearch`, e.g. `2025`. Empty = last year.", "default": [], "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Language of the Trends interface and preferred language of articles, e.g. `en-US`, `de`, `pl`.", "default": "en-US" }, "maxRunSecs": { "title": "Max run time (seconds)", "minimum": 0, "type": "integer", "description": "Stop after this time with partial results (0 = only the run timeout applies).", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy for Trending Now lists, articles and Year in Search (no rate limits observed; the default Apify Proxy is enough).", "default": { "useApifyProxy": true } }, "chartProxyConfiguration": { "title": "Proxy for trend charts", "type": "object", "description": "Proxy for the interest-over-time charts (`includeTrendTimeline`), which use the rate-limited Google Trends Explore API. Default: residential proxies with a new IP per chart; falls back to the default Apify Proxy if residential is not available.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }