{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper: Queries, Regions & Trending Now", "description": "Scrape Google Trends: interest over time, interest by region, related and rising queries, and real-time Trending Now searches. Batch up to 100 keywords, any country, any timeframe. Charged per row of real data, so a keyword that returns nothing costs nothing.", "version": "0.2", "x-build-id": "dUamju9nmWQnrtKKX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/glitchbound~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-glitchbound-google-trends-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/glitchbound~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-glitchbound-google-trends-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/glitchbound~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-glitchbound-google-trends-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": { "keywords": { "title": "Keywords", "uniqueItems": true, "type": "array", "description": "Search terms to analyze, one per line. Each keyword is fetched independently (its scores are normalized 0-100 against itself). Up to 100 per run. Keyword analysis needs your own proxy, because Google rate-limits every shared datacenter and residential address Apify can reach for this endpoint. Trending Now below needs no proxy.", "items": { "type": "string" } }, "compareKeywords": { "title": "Compare keywords against each other", "type": "boolean", "description": "Score all your keywords on ONE shared 0-100 scale, so they can be compared directly (e.g. is Nike or Adidas trending harder?). Uses the first 5 keywords, and returns each one's average, peak, and rank. Leave off to analyze each keyword independently.", "default": false }, "dataTypes": { "title": "Data to fetch per keyword", "type": "array", "description": "Which datasets to fetch for every keyword. Ignored when 'Compare keywords' is on.", "items": { "type": "string", "enum": [ "interestOverTime", "interestByRegion", "relatedQueries" ], "enumTitles": [ "Interest over time", "Interest by region", "Related queries (top + rising)" ] }, "default": [ "interestOverTime", "relatedQueries" ] }, "geo": { "title": "Country / region", "type": "string", "description": "Two-letter country code (US, GB, DE, IL…), or a region like US-NY. Leave empty for worldwide." }, "timeframe": { "title": "Timeframe", "enum": [ "now 1-H", "now 4-H", "now 1-d", "now 7-d", "today 1-m", "today 3-m", "today 12-m", "today 5-y", "all" ], "type": "string", "description": "Google Trends timeframe.", "default": "today 12-m" }, "regionResolution": { "title": "Region breakdown level", "enum": [ "COUNTRY", "REGION", "DMA" ], "type": "string", "description": "Granularity for interest-by-region.", "default": "COUNTRY" }, "category": { "title": "Category ID", "type": "integer", "description": "Google Trends category ID to narrow results (0 = all categories). Example: 71 = Food & Drink.", "default": 0 }, "property": { "title": "Search surface", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Which Google surface to measure.", "default": "" }, "trendingNowGeo": { "title": "Trending Now countries", "type": "string", "description": "Real-time trending searches for these countries, e.g. US or US, GB, DE, IL. Served from Google's trending RSS feed, which is not rate-limited on Apify, so it works with no proxy of your own. Several countries run in one job and each row carries its own country and its rank within that country. Works with or without keywords." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy settings. Measured 2026-07-29: Apify Proxy does not get past Google's block on this endpoint - datacenter, residential and no-proxy all return 429 while an ordinary home connection succeeds in the same minute. If you have your own clean proxy, put it in Custom proxy URLs; that is the one setting here that changes the outcome.", "default": { "useApifyProxy": true } }, "maxItems": { "title": "Maximum results (whole run)", "minimum": 0, "type": "integer", "description": "A hard ceiling on rows for the entire run, across every target. The per-target limits above cap each one separately, so fifty targets at twenty each is still a thousand rows; this caps the total. The run stops cleanly when it is reached and nothing beyond that point is fetched or charged. Leave empty for no ceiling." } } }, "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 } } } } } } } } } }