{ "openapi": "3.0.1", "info": { "title": "Google Trending Now History", "description": "Search every Google Trending Now trend since Nov 2024 across 1,358 countries, regions and US metros: find every time a keyword trended or what was trending on any day, with search volume, duration and related searches. Nov 2024 – May 2026 is free.", "version": "0.1", "x-build-id": "yMIcRxrSJgmKlADwe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seodatalab~google-trending-now-history/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seodatalab-google-trending-now-history", "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/seodatalab~google-trending-now-history/runs": { "post": { "operationId": "runs-sync-seodatalab-google-trending-now-history", "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/seodatalab~google-trending-now-history/run-sync": { "post": { "operationId": "run-sync-seodatalab-google-trending-now-history", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Find every time these terms trended. Matches trend titles (and related searches, see below), case-insensitive. Leave empty to list everything that trended in the date range.", "items": { "type": "string" } }, "matchMode": { "title": "Keyword match", "enum": [ "contains", "exact" ], "type": "string", "description": "\"contains\" finds 'taylor swift tickets' for 'taylor swift'. \"exact\" finds only 'taylor swift'.", "default": "contains" }, "searchRelatedSearches": { "title": "Also match related searches", "type": "boolean", "description": "Also return trends whose related searches contain a keyword (e.g. 'eagles vs chiefs' for 'super bowl').", "default": true }, "geos": { "title": "Locations", "type": "array", "description": "Country (US, GB, IN…), region (US-CA, IN-MH…) or US metro codes (501 = New York). Empty = all 1,358 locations.", "items": { "type": "string" } }, "includeSubregions": { "title": "Include regions and metros of these countries", "type": "boolean", "description": "US also returns US-CA, US-NY… and US metro areas.", "default": false }, "dateFrom": { "title": "From date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Trends that started on or after this day (UTC). Default: 2024-11-28 with keywords, otherwise 7 days ago." }, "dateTo": { "title": "To date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Trends that started on or before this day (UTC). Default: today." }, "categories": { "title": "Categories", "type": "array", "description": "Only trends in these categories. Categories exist only in the live archive (from Nov 2026), so this filter excludes academic-archive rows.", "items": { "type": "string", "enum": [ "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" ] } }, "minSearchVolume": { "title": "Min search volume", "minimum": 0, "type": "integer", "description": "Skip smaller trends. Volumes are Google's buckets (e.g. 20000 = '20K+').", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "newest", "oldest", "searchVolume" ], "type": "string", "description": "Order of results.", "default": "newest" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many trends (up to 100,000 per run; split bigger exports by date).", "default": 1000 }, "includeAcademicArchive": { "title": "Include the free academic archive (Nov 2024 – May 2026)", "type": "boolean", "description": "Rows from GoogleTrendArchive (Urman, Hannák & Baumann, CC BY 4.0) are free and never charged.", "default": true }, "maxDataAgeHours": { "title": "Max data age (hours)", "minimum": 1, "maximum": 720, "type": "integer", "description": "For monitoring: return no results when the newest collected data is older than this many hours." } } }, "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 } } } } } } } } } }