{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper & API - Interest, Regions, Rising Queries", "description": "Google Trends data for a list of keywords: interest over time (0-100), interest by region, related and rising queries, plus ready-made average, peak and trend direction. Also Trending Now searches by country. Any country, time range, category and search type. $0.005 per keyword, all data included.", "version": "0.1", "x-build-id": "naqFiekFEfDZ61Sfo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/orbifetch~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-orbifetch-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/orbifetch~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-orbifetch-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/orbifetch~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-orbifetch-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 in Google Trends, e.g. chatgpt, running shoes. Each keyword returns one row with interest over time, interest by region and related queries. Provide searchTerms, trendingNowCountries, or both.", "items": { "type": "string" } }, "compareTerms": { "title": "Compare terms against each other", "type": "boolean", "description": "Compare keywords in groups of up to 5 on the same 0-100 scale, like typing them into Google Trends together. When off, each keyword is scaled independently.", "default": false }, "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 analyze. Values: \"now 1-H\" (past hour), \"now 4-H\", \"now 1-d\" (past day), \"now 7-d\", \"today 1-m\" (past 30 days), \"today 3-m\", \"today 12-m\" (default), \"today 5-y\", \"all\" (2004 to present). Ignored when customTimeRange is set.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Optional. Exact date range as \"YYYY-MM-DD YYYY-MM-DD\", e.g. \"2024-01-01 2024-06-30\". Overrides timeRange." }, "geo": { "title": "Location", "type": "string", "description": "Country or region code (ISO 3166), e.g. US, GB, DE, TR, US-CA. Leave empty for worldwide.", "default": "" }, "category": { "title": "Category ID", "type": "integer", "description": "Google Trends category ID (0 = all categories). Examples: 3 = Arts & Entertainment, 7 = Finance, 12 = Business & Industrial, 45 = Health, 71 = Food & Drink, 5 = Computers & Electronics.", "default": 0 }, "property": { "title": "Search type", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Which Google search to analyze. Values: \"\" (web search, default), \"images\", \"news\", \"youtube\", \"froogle\" (Google Shopping).", "default": "" }, "includeInterestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Timeline of search interest (0-100) plus average, peak and trend direction.", "default": true }, "includeInterestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Where the keyword is most popular: 0-100 per region, at the resolution set below.", "default": true }, "regionResolution": { "title": "Region resolution", "enum": [ "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Granularity of interest by region. Values: COUNTRY (default), REGION (state/province), CITY, DMA (US metros only). Inside a country, COUNTRY automatically becomes REGION.", "default": "COUNTRY" }, "includeLowVolumeRegions": { "title": "Include low-volume regions", "type": "boolean", "description": "Also return regions with low search volume (Google Trends hides them by default).", "default": false }, "includeRelatedQueries": { "title": "Related & rising queries", "type": "boolean", "description": "Top related searches and rising (breakout) searches for each keyword.", "default": true }, "trendingNowCountries": { "title": "Trending now: countries", "type": "array", "description": "Optional. 2-letter country codes, e.g. US, GB, IN. Returns today's Trending Now searches per country, with traffic estimates and news links (billed per trending search). Works without searchTerms.", "items": { "type": "string" } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Keywords processed in parallel (1-10, default 3). Higher values may trigger Google rate limits; the Actor retries automatically.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google Trends blocks data-center IPs quickly. Residential proxies (default) give the most reliable results.", "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 }, "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 } } } } } } } } } }