{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now API — Real-Time Trending Searches", "description": "Real-time trending searches from Google Trends (Trending Now, which replaced Daily and Realtime Search Trends) for 125 countries & US states in one run: search volume, growth, start/end, related searches, categories & news. Only-new mode for alerts. Pay per trend.", "version": "1.0", "x-build-id": "Oi8XVLYqHhRzFENWW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insanedev~google-trends-trending-now/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insanedev-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/insanedev~google-trends-trending-now/runs": { "post": { "operationId": "runs-sync-insanedev-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/insanedev~google-trends-trending-now/run-sync": { "post": { "operationId": "run-sync-insanedev-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", "properties": { "countries": { "title": "Countries", "type": "array", "description": "Countries to get Trending Now for (125 available). Each country is fetched in full — every trend Google lists, not just the top 10 of the RSS feed.", "items": { "type": "string", "enum": [ "AL", "DZ", "AO", "AR", "AM", "AU", "AT", "AZ", "BH", "BD", "BY", "BE", "BJ", "BO", "BA", "BR", "BG", "BF", "KH", "CM", "CA", "CL", "CO", "CR", "CI", "HR", "CU", "CY", "CZ", "DK", "DO", "CD", "EC", "EG", "SV", "EE", "ET", "FI", "FR", "GE", "DE", "GH", "GR", "GT", "HT", "HN", "HK", "HU", "IN", "ID", "IR", "IQ", "IE", "IL", "IT", "JM", "JP", "JO", "KZ", "KE", "KW", "KG", "LV", "LB", "LY", "LT", "MY", "ML", "MX", "MD", "MA", "MZ", "MM", "NP", "NL", "NZ", "NI", "NG", "MK", "NO", "OM", "PK", "PS", "PA", "PY", "PE", "PH", "PL", "PT", "PR", "QA", "RO", "RU", "SA", "SN", "RS", "SG", "SK", "SI", "ZA", "KR", "ES", "LK", "SE", "CH", "SY", "TW", "TZ", "TH", "TT", "TN", "TR", "TM", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VE", "VN", "YE", "ZM", "ZW" ], "enumTitles": [ "Albania", "Algeria", "Angola", "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Belarus", "Belgium", "Benin", "Bolivia", "Bosnia & Herzegovina", "Brazil", "Bulgaria", "Burkina Faso", "Cambodia", "Cameroon", "Canada", "Chile", "Colombia", "Costa Rica", "Côte d’Ivoire", "Croatia", "Cuba", "Cyprus", "Czechia", "Denmark", "Dominican Republic", "DR Congo", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Finland", "France", "Georgia", "Germany", "Ghana", "Greece", "Guatemala", "Haiti", "Honduras", "Hong Kong", "Hungary", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kazakhstan", "Kenya", "Kuwait", "Kyrgyzstan", "Latvia", "Lebanon", "Libya", "Lithuania", "Malaysia", "Mali", "Mexico", "Moldova", "Morocco", "Mozambique", "Myanmar", "Nepal", "Netherlands", "New Zealand", "Nicaragua", "Nigeria", "North Macedonia", "Norway", "Oman", "Pakistan", "Palestine", "Panama", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Saudi Arabia", "Senegal", "Serbia", "Singapore", "Slovakia", "Slovenia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sweden", "Switzerland", "Syria", "Taiwan", "Tanzania", "Thailand", "Trinidad & Tobago", "Tunisia", "Türkiye", "Turkmenistan", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Venezuela", "Vietnam", "Yemen", "Zambia", "Zimbabwe" ] } }, "allCountries": { "title": "All countries", "type": "boolean", "description": "Fetch all 125 countries in one run (≈ 5,000 trends for the past 24 hours).", "default": false }, "regions": { "title": "States and regions", "type": "array", "description": "States and regions by code — Google publishes Trending Now for 1,013 of them in 43 countries: all US states (`US-CA`, `US-NY`, …), `GB-ENG`/`GB-SCT`/`GB-WLS`/`GB-NIR`, German states (`DE-BY`), Canadian provinces (`CA-ON`), Indian states (`IN-MH`), Japanese prefectures (`JP-13` = Tokyo), French regions (letter codes: `FR-J` = Île-de-France), and more (see README). Country codes work here too. Codes without a list are listed in the run summary and cost nothing.", "items": { "type": "string" } }, "timeWindow": { "title": "Time window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Trends that started within this window, like the time filter on Google's Trending Now page.", "default": "24" }, "customHours": { "title": "Custom window (hours)", "minimum": 1, "maximum": 191, "type": "integer", "description": "Any window from 1 to 191 hours (Google keeps about 8 days). Overrides the time window above." }, "newsPerTrend": { "title": "News articles per trend", "minimum": 0, "maximum": 20, "type": "integer", "description": "Headlines, links, sources and images of the news behind each trend (0–20). Included in the price.", "default": 3 }, "maxTrendsPerRegion": { "title": "Max trends per country/region", "minimum": 0, "type": "integer", "description": "Stop after this many trends per country or region (after filters and sorting). Leave empty or 0 for all of them — the US alone has 400+ trends in 24 hours." }, "categories": { "title": "Categories", "type": "array", "description": "Keep only trends in these categories (a trend can be in several). Empty = all categories.", "items": { "type": "string", "enum": [ "autos", "beauty", "business", "climate", "entertainment", "food", "games", "health", "hobbies", "jobs", "law", "other", "pets", "politics", "science", "shopping", "sports", "technology", "travel" ], "enumTitles": [ "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" ] } }, "activeOnly": { "title": "Active trends only", "type": "boolean", "description": "Skip trends that have already ended (Google's \"Active trends only\" switch).", "default": false }, "minSearchVolume": { "title": "Minimum search volume", "minimum": 0, "type": "integer", "description": "Skip trends below this search volume (Google's buckets: 100, 200, 500, 1000, 2000, 5000, 10000, 20000, 50000, 100000, 200000, 500000, 1000000+).", "default": 0 }, "includeKeywords": { "title": "Only trends mentioning", "type": "array", "description": "Watchlist: keep a trend only if it or one of its related searches contains any of these words (case and accents ignored), e.g. your brand or competitors.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Skip trends mentioning", "type": "array", "description": "Skip trends containing any of these words (case and accents ignored).", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "searchVolume", "growth", "newest" ], "type": "string", "description": "Order of trends within each country/region.", "default": "relevance" }, "onlyNew": { "title": "Only new trends", "type": "boolean", "description": "Deliver only trends that previous runs have not delivered yet (plus trends that ended and started trending again). Ideal for hourly schedules and Slack/e-mail alerts — you pay only for new trends. Each saved task keeps its own memory.", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Optional name for the memory of \"Only new trends\" when you run the Actor via API without a saved task. Runs with the same key share what was already delivered." }, "outputDatasetName": { "title": "Also save to dataset (your history)", "type": "string", "description": "Name of a dataset every delivered trend is also appended to (created on the first run, kept after the run's own data expires). With a schedule and \"Only new trends\" this builds your own Trending Now history — Google keeps only about 8 days." }, "strictStatus": { "title": "Strict status", "type": "boolean", "description": "Fail the run when more than half of the countries/regions fail (for uptime monitoring).", "default": 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 } } } } } } } } } }