{ "openapi": "3.0.1", "info": { "title": "Google Trends Trending Now Scraper — Live Trending Searches", "description": "Google's trending searches for any country: rank, the traffic floor Google publishes, when each trend started, and the news stories behind it. From $0.50 per 1,000 trending searches, no start fee — poll it every hour. Never charged for an empty pull.", "version": "1.0", "x-build-id": "vbCBZAcm275Pq7KTc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyfetch~google-trends-now-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyfetch-google-trends-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/steadyfetch~google-trends-now-scraper/runs": { "post": { "operationId": "runs-sync-steadyfetch-google-trends-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/steadyfetch~google-trends-now-scraper/run-sync": { "post": { "operationId": "run-sync-steadyfetch-google-trends-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", "required": [ "geo" ], "properties": { "geo": { "title": "Country", "type": "string", "description": "A two-letter country code, e.g. \"US\" — GB, IN, DE, BR, SA and so on; Google publishes its trending searches per country. A country Google does not cover comes back as an uncharged row naming the fix, and neither an empty pull nor a trend filtered out by minTraffic is charged. Use geos to poll several countries in one run; a full 0-100 timeline for a term is at steadyfetch/google-trends-scraper. Leave this untouched and click Start to run a 5-row US sample — and if you set limits below but still no country, that same sample runs under them.", "default": "" }, "geos": { "title": "More countries (optional)", "type": "array", "description": "Poll several countries in one run. Each is fetched independently, gets its own rows, and one country being down never blocks the others.", "default": [], "items": { "type": "string" } }, "maxTrendsPerGeo": { "title": "Max trends per country", "minimum": 1, "type": "integer", "description": "Google publishes 10 trending searches per country, so 10 is both the default and the ceiling. Ask for more and the run continues at 10, with one uncharged row saying so. Lower it to spend less per poll.", "default": 10 }, "minTraffic": { "title": "Minimum traffic", "minimum": 0, "type": "integer", "description": "Skip trends below this search-volume floor. Google publishes a floor like \"2000+\", so 2000 keeps that trend and everything busier. Trends filtered out here are never charged. Leave at 0 to keep all of them.", "default": 0 }, "includeNews": { "title": "Include the news stories", "type": "boolean", "description": "Attach the news articles Google links to each trend (headline, source and URL). Turn it off for a smaller payload; the story count is reported either way.", "default": true }, "maxItems": { "title": "Max trends for the whole run", "minimum": 1, "type": "integer", "description": "Hard cap on delivered trends across every country in this run — up to 2,000. Ask for more and the run continues at 2,000, with one uncharged row saying so.", "default": 100 }, "maxRunSeconds": { "title": "Max run seconds", "type": "integer", "description": "The run stops cleanly before this many seconds and reports what is left, instead of being killed by a timeout. One country typically answers in well under a second; when Google refuses one, the run may wait a few minutes inside this window and ask again before it reports the refusal. Anything from 15 seconds to an hour; ask outside that and the run continues at the nearest end of it, with one uncharged row saying so.", "default": 600 } } }, "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 } } } } } } } } } }