{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now Scraper — Searches + News by Country", "description": "Get Google Trends \"Trending Now\" searches for any country or region: up to 600+ live trending queries per geo with search volume, % growth, start/end time, category, breakdown keywords and related news articles. Many geos per run, 4h–7 day windows. No login, no browser, no start fee.", "version": "0.1", "x-build-id": "03eog3KDcBpIK8bzj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~google-trends-trending-now-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-google-trends-trending-now-scraper", "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/scrapersdelight~google-trends-trending-now-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-google-trends-trending-now-scraper", "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/scrapersdelight~google-trends-trending-now-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-google-trends-trending-now-scraper", "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": { "geos": { "title": "Countries / regions (geo codes)", "type": "array", "description": "One or more ISO-3166 codes exactly as Google Trends uses them: a country (\"US\", \"GB\", \"IN\", \"DE\", \"JP\", \"BR\") or a region (\"US-CA\", \"US-NY\", \"GB-ENG\"). Every geo is one request and yields its own full trending list — measured 2026-08-22 at 24h: US 606, GB 544, JP 515, DE 424, US-CA 250, SE 115 rows.", "default": [ "US" ], "items": { "type": "string" } }, "hours": { "title": "Time window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "The four windows the Trending Now page offers. Longer windows return more rows (US measured: 4h → 95, 24h → 606, 48h → 1,061, 7 days → 2,959).", "default": "24" }, "categories": { "title": "Categories", "type": "array", "description": "Keep only trends Google tagged with at least one of these categories. Leave empty for all 19. Applied before billing — filtered rows cost nothing.", "items": { "type": "string", "enum": [ "1", "2", "3", "20", "4", "5", "6", "7", "8", "9", "10", "11", "13", "14", "15", "16", "17", "18", "19" ], "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" ] }, "default": [] }, "trendStatus": { "title": "Trend status", "enum": [ "all", "active", "ended" ], "type": "string", "description": "\"Active\" = Google has not marked the trend as ended (no endedAt). \"Ended\" = it has. Measured at 7 days for US: 195 of 2,959 active.", "default": "all" }, "minSearchVolume": { "title": "Minimum search volume", "minimum": 0, "type": "integer", "description": "Drop trends below this search-volume bucket. Google's buckets are 100 / 200 / 500 / 1K / 2K / 5K / 10K / 20K / 50K / 100K / 200K / 500K / 1M+. 0 = keep everything.", "default": 0 }, "sortBy": { "title": "Sort order", "enum": [ "default", "volume", "recency", "growth" ], "type": "string", "description": "\"Google's order\" is the order the Trending Now page lists them (rank is kept in every row regardless). The other options re-sort each geo before the caps are applied, so \"Search volume\" + maxItems 50 = the 50 biggest trends.", "default": "default" }, "includeNews": { "title": "Attach related news articles", "type": "boolean", "description": "ON: fetches the news articles Google links to each trend (title, URL, source, published time, image) — charged as a separate news-articles-added event ONLY on rows that actually receive at least one article. OFF: rows ship with an empty newsArticles list and only the per-trend event is charged.", "default": true }, "maxNewsPerTrend": { "title": "Max news articles per trend", "minimum": 1, "maximum": 10, "type": "integer", "description": "Cap how many articles are attached per trend. Google's news lookup returns at most 3 per trend (measured: 3 on every enriched row across 3,000+ rows), so values above 3 change nothing.", "default": 3 }, "maxItems": { "title": "Max trends (total)", "minimum": 0, "type": "integer", "description": "Your hard cost cap across all geos. 100 = $0.20 (+ up to $0.10 for news). Set 0 for everything the window holds — a 7-day US pull is ~3,000 rows.", "default": 100 }, "maxItemsPerGeo": { "title": "Max trends per geo", "minimum": 0, "type": "integer", "description": "Cap per country/region so one big geo does not use the whole budget. 0 = no per-geo cap.", "default": 0 }, "language": { "title": "Interface language (hl)", "type": "string", "description": "Google Trends locale for category names, the geoName field and the language of linked news (\"en-US\", \"en-GB\", \"de\", \"fr\", \"es\", \"pt-BR\", \"ja\"). Queries themselves are always in the language people searched in.", "default": "en-US" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is the default and is enough — measured 20/20 geos + 20/20 news batches clean through the datacenter pool on 2026-08-22. RESIDENTIAL also works (19/20) but costs more per MB.", "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 } } }, "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 } } } } } } } } } }