{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Fast, reliable Google Trends data — interest over time, interest by region, related queries & topics for any keyword, plus daily trending searches. Built-in rate-limit handling. Any country, category, time range.", "version": "0.1", "x-build-id": "eMpeQ941UdGETJkV6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/native_emblem~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-native_emblem-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/native_emblem~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-native_emblem-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/native_emblem~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-native_emblem-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to look up on Google Trends. Each term produces one dataset record with interest over time, interest by region, related queries and related topics. Values are relative (0–100) within each term.", "items": { "type": "string" } }, "timeRange": { "title": "Time range", "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": "Period to analyse.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Overrides Time range. Format: \"YYYY-MM-DD YYYY-MM-DD\", e.g. \"2025-01-01 2025-06-30\"." }, "geo": { "title": "Location", "type": "string", "description": "Two-letter country code (US, GB, DE…) or region code (US-CA). Leave empty for worldwide." }, "category": { "title": "Category", "type": "integer", "description": "Google Trends category ID to narrow results (0 = all categories). E.g. 7 = Finance, 8 = Games, 16 = News, 45 = Health, 3 = Arts & Entertainment.", "default": 0 }, "property": { "title": "Search type", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Which Google property to analyse.", "default": "" }, "includeInterestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Include the interest-over-time series (0–100 per time bucket).", "default": true }, "includeInterestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Include the geographic breakdown of interest.", "default": true }, "includeRelatedQueries": { "title": "Related queries", "type": "boolean", "description": "Include top & rising related search queries.", "default": true }, "includeRelatedTopics": { "title": "Related topics", "type": "boolean", "description": "Include top & rising related topics.", "default": true }, "regionResolution": { "title": "Region breakdown level", "enum": [ "AUTO", "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Granularity of Interest by region. AUTO lets Google pick (countries for worldwide, subregions for a country). COUNTRY, REGION and DMA (US metro areas) return full data; CITY is served selectively by Google and can come back empty.", "default": "AUTO" }, "trendingNow": { "title": "Scrape trending searches", "type": "boolean", "description": "Also fetch today's trending searches (Trending Now) — one record per trending story with traffic estimate and news links.", "default": false }, "trendingGeos": { "title": "Trending locations", "type": "array", "description": "Country codes to fetch trending searches for (used only when Scrape trending searches is on).", "default": [ "US" ], "items": { "type": "string" } }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many search terms to process in parallel (1–10). Higher = faster runs; each term uses its own proxy session, so parallelism is safe.", "default": 5 }, "language": { "title": "Language", "type": "string", "description": "Locale for formatted labels and topic names (hl parameter).", "default": "en-US" }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after pushing this many records. Leave empty for no limit." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google throttles Trends heavily per IP. RESIDENTIAL proxies are strongly recommended — datacenter IPs are widely blocked by Google and will produce mostly failed terms.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }