{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper - Compare Unlimited Keywords", "description": "Get Google Trends interest over time, interest by region, related queries and trending searches. Compare more than 5 keywords on one 0-100 scale. Fast, no browser, and failed keywords are never charged.", "version": "1.0", "x-build-id": "9ubHbYT5Tr4v7h97a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fairscrape~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fairscrape-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/fairscrape~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-fairscrape-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/fairscrape~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-fairscrape-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 is one result. In 'Compare' mode there is no 5-keyword limit: all terms end up on one shared 0-100 scale.", "default": [ "chatgpt", "gemini", "claude" ], "items": { "type": "string" } }, "compareMode": { "title": "Mode", "enum": [ "individual", "compare" ], "type": "string", "description": "'Individual' scores each term on its own 0-100 scale (best for spotting each term's trend). 'Compare' puts all terms on one scale so you can see which is searched more (like typing them together in Google Trends, but without the 5-term limit).", "default": "individual" }, "geo": { "title": "Country or region", "type": "string", "description": "Two-letter country code like US, BR, GB, DE, or a region like US-CA. Leave empty for worldwide.", "default": "" }, "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. Short ranges give hourly/daily points, long ranges give weekly/monthly points.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Overrides 'Time range'. Format: YYYY-MM-DD YYYY-MM-DD, for example 2024-01-01 2024-12-31." }, "property": { "title": "Search type", "enum": [ "", "images", "news", "froogle", "youtube" ], "type": "string", "description": "Which Google search to measure.", "default": "" }, "category": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Optional Google Trends category (0 = all). Find the ID in the 'cat=' part of a Google Trends URL, e.g. 7 = Finance, 18 = Shopping, 20 = Sports.", "default": 0 }, "includeInterestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Timeline of search interest (0-100) plus a summary: average, peak, latest value, % change and trend direction.", "default": true }, "includeInterestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Where the term is most popular.", "default": true }, "regionResolution": { "title": "Region level", "enum": [ "", "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Level of detail for 'Interest by region'. Leave on default to let Google choose (countries for worldwide, states/provinces for a country).", "default": "" }, "includeRelatedQueries": { "title": "Related queries", "type": "boolean", "description": "Top and rising searches related to each term. Great for keyword research and content ideas.", "default": true }, "includeRelatedTopics": { "title": "Related topics", "type": "boolean", "description": "Top and rising topics (Individual mode only). Off by default: Google often withholds topics for automated traffic, so this block may come back empty.", "default": false }, "trendingNowGeos": { "title": "Trending now: countries", "type": "array", "description": "Optional. Two-letter country codes (e.g. US, BR, GB) to also get today's trending searches with approximate traffic and news links.", "items": { "type": "string" } }, "maxTrendingItems": { "title": "Max trending searches per country", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many trending searches to return per country (Google lists up to about 100 per day).", "default": 50 }, "language": { "title": "Language", "type": "string", "description": "Language for names of regions and topics, e.g. en-US, pt-BR, es-ES.", "default": "en-US" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many terms are processed in parallel (Individual mode).", "default": 3 }, "maxRetries": { "title": "Max retries per request", "minimum": 1, "maximum": 20, "type": "integer", "description": "Google rate-limits aggressively. Each retry uses a fresh proxy IP.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are strongly recommended, Google blocks datacenter IPs quickly.", "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 } } } } } } } } } }