{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now Scraper with News", "description": "Google Trends' full Trending Now list for any country or region, with the news articles behind each trend, search volume, growth %, start and end times. Pay only per trend delivered. No browser.", "version": "0.1", "x-build-id": "LsxfDc7z9CLbNknfT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/curiousanand~google-trends-trending-now/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-curiousanand-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/curiousanand~google-trends-trending-now/runs": { "post": { "operationId": "runs-sync-curiousanand-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/curiousanand~google-trends-trending-now/run-sync": { "post": { "operationId": "run-sync-curiousanand-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": { "geo": { "title": "Countries or regions", "maxItems": 50, "type": "array", "description": "Country codes (US, GB, IN), regions (US-CA, DE-BY) or country names (Germany). Up to 50 per run. Trending Now has no worldwide list, but \"ALL\" gives every country that has one (125; set maxItemsPerGeo with it).", "default": [ "US" ], "items": { "type": "string" } }, "hours": { "title": "Time window", "type": "string", "description": "How far back Trending Now looks. Also accepts \"past 7 days\", \"last 24 hours\", \"48h\". US list size: 4 h ≈ 100, 24 h ≈ 630, 48 h ≈ 1,050, 7 days ≈ 3,300 trends.", "default": "24" }, "categories": { "title": "Categories", "type": "array", "description": "Only trends in these categories. Empty = all. Names or ids as text (\"17\").", "items": { "type": "string", "enumSuggestedValues": [ "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": [] }, "status": { "title": "Trend status", "type": "string", "description": "All trends, only those still trending (active), or only those that have ended.", "default": "all" }, "minSearchVolume": { "title": "Minimum search volume", "minimum": 0, "type": "integer", "description": "Only trends with at least this many searches (Google's lower bound, e.g. 1000 for \"1K+\"). 0 = no minimum. Trends without a volume are dropped when this is above 0.", "default": 0 }, "sortBy": { "title": "Sort by", "type": "string", "description": "Order of the trends in each country, applied before the per-country limit, so \"top 20 by volume\" works. Ties keep Google's order. The rank field always keeps Google's position.", "default": "relevance" }, "maxItemsPerGeo": { "title": "Max trends per country/region", "minimum": 0, "type": "integer", "description": "Keep the first N trends per geo after filters and sorting (Google's order unless you sort). 0 = the full list. Cost: $1.00 per 1,000 trends delivered (US 24 h full list ≈ $0.63).", "default": 0 }, "includeNews": { "title": "Include news articles", "type": "boolean", "description": "Fetch the news articles behind each trend (title, link, source, time, image). Included in the price; trends whose news fails are free.", "default": true }, "maxNewsPerTrend": { "title": "News articles per trend", "minimum": 0, "type": "integer", "description": "Up to 30. 0 turns news off.", "default": 3 }, "onlyNew": { "title": "Only new trends since the last run", "type": "boolean", "description": "For scheduled monitoring: skip trends an earlier run with the same settings already delivered. Remembered in your key-value store \"trending-now-seen\" for 8 days. Don't run two of these at the same time with the same settings.", "default": false }, "stateKey": { "title": "Memory name (optional)", "pattern": "^[a-zA-Z0-9_-]{0,64}$", "type": "string", "description": "Name for the onlyNew memory, e.g. \"daily-us-sports\". Empty = automatic per filter settings. Letters, digits, - and _ only.", "default": "" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is included in the price. If Google blocks, the run switches to residential proxies on its own.", "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 } } } } } } } } } }