{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now Scraper - All Trends, Volume & News", "description": "Get every trending search from Google Trends \"Trending now\" for any country or US state: search volume, growth, start and end time, active status, category, related queries and news articles. Past 4 hours to 7 days. Pay only for trends delivered.", "version": "0.1", "x-build-id": "X3kmylRfmRttuCRgg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alaathr~google-trends-trending-now/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alaathr-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/alaathr~google-trends-trending-now/runs": { "post": { "operationId": "runs-sync-alaathr-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/alaathr~google-trends-trending-now/run-sync": { "post": { "operationId": "run-sync-alaathr-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", "required": [ "countries" ], "properties": { "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes (US, GB, FR, DE, IN, BR, MA...) or US states (US-CA, US-NY). One result list per location.", "items": { "type": "string" } }, "timeRange": { "title": "Time range", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Trends that started within this period.", "default": "24" }, "categories": { "title": "Categories", "type": "array", "description": "Keep only trends in these categories. Leave empty for all categories.", "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" ] }, "default": [] }, "activeOnly": { "title": "Active trends only", "type": "boolean", "description": "Keep only trends that are still rising (Google shows them as \"Active\").", "default": false }, "minSearchVolume": { "title": "Minimum search volume", "minimum": 0, "type": "integer", "description": "Keep only trends with at least this many searches (Google's lower bound, for example 1000 for \"1K+\").", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "google", "searchVolume", "growth", "newest" ], "type": "string", "description": "Order of the results within each location. Each result keeps Google's original rank.", "default": "google" }, "maxItemsPerCountry": { "title": "Max trends per location", "minimum": 0, "type": "integer", "description": "Stop after this many trends per location, after filters and sorting. 0 means all (a US 7-day run returns about 3,000 trends).", "default": 0 }, "includeNews": { "title": "Include news articles", "type": "boolean", "description": "Add the news articles Google links to each trend: title, link, source, date and image.", "default": true }, "newsPerTrend": { "title": "News articles per trend", "minimum": 1, "maximum": 25, "type": "integer", "description": "How many news articles to add to each trend (1 to 25).", "default": 3 }, "includeRelatedQueries": { "title": "Include related queries", "type": "boolean", "description": "Add the related searches Google groups under each trend (its \"trend breakdown\").", "default": true }, "language": { "title": "Language", "type": "string", "description": "Language code for the request, for example en-US, fr, de or es. The trends themselves come from the chosen location.", "default": "en-US" }, "maxConcurrency": { "title": "Parallel locations", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many locations are fetched at the same time.", "default": 3 }, "maxRetries": { "title": "Attempts per location", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many fresh sessions are tried for a location before it is reported as failed (failed locations are not charged).", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies used to reach Google Trends. The default works for most runs.", "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 } } } } } } } } } }