{ "openapi": "3.0.1", "info": { "title": "Google Trends Keyword Scraper Pro | SEO & Market Research", "description": "Compare Google Trends interest over time, regions, related queries, and trending searches for SEO, content strategy, market research, and competitive analysis. Export structured trend data with flexible timeframes and locations.", "version": "0.0", "x-build-id": "DbGB5n3KiLrdnRpxs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtech~google-keyword-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtech-google-keyword-scraper-pro", "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/xtech~google-keyword-scraper-pro/runs": { "post": { "operationId": "runs-sync-xtech-google-keyword-scraper-pro", "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/xtech~google-keyword-scraper-pro/run-sync": { "post": { "operationId": "run-sync-xtech-google-keyword-scraper-pro", "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/Topics", "minItems": 1, "maxItems": 5, "type": "array", "description": "Enter a list of keywords or Google Trends topic IDs (e.g., [\"Python\", \"Artificial Intelligence\", \"/m/025rw19\"] for Taylor Swift). You can compare up to 5 items. Required for search types that analyze keyword/topic interest (e.g., interestOverTime, relatedQueries).", "items": { "type": "string" } }, "timeframe": { "title": "Timeframe", "type": "string", "description": "Specify the time period for the trend data. Examples: 'today 5-y' (last 5 years), 'today 12-m' (last 12 months), 'now 7-d' (last 7 days, hourly data), '2020-01-01 2020-12-31' (custom range). Defaults to 'today 5-y'. For hourly data, use 'now 1-d' or 'now 7-d'.", "default": "today 5-y" }, "searchType": { "title": "Search Type", "enum": [ "interestOverTime", "interestByRegion", "relatedTopics", "relatedQueries", "trendingSearches", "realtimeTrendingSearches", "trendingNowNews", "trendingNowShowcaseTimeline", "categories", "geo" ], "type": "string", "description": "Select the Google Trends endpoint to use. (See README for details.)", "default": "interestOverTime" }, "geoLocation": { "title": "Geo Location (Country/Region)", "type": "string", "description": "Specify a geographic region for the trends data. Use two-letter ISO 3166-1 alpha-2 country codes (e.g., 'US', 'GB', 'DE'). For subdivisions (e.g., states, regions), use codes like 'US-CA' for California. Leave empty for worldwide data. Not applicable for 'trendingSearches' or 'realtimeTrendingSearches' which use a separate field.", "default": "" }, "category": { "title": "Category", "type": "integer", "description": "Filter trends by a specific category. For example, 71 corresponds to 'Real Estate'. Refer to Google Trends documentation or explore the Google Trends website to find relevant category numbers. Defaults to 0 (all categories).", "default": 0 }, "googleProperty": { "title": "Google Property", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Filter trends by a specific Google property (e.g., Images, News, YouTube, Shopping). Defaults to standard web search.", "default": "" }, "trendingSearchesCountry": { "title": "Trending Searches Country", "type": "string", "description": "Required ONLY if 'Search Type' is 'Daily Trending Searches' or 'Real-time Trending Searches'. Provide the two-letter ISO 3166-1 alpha-2 country code (e.g., 'US' for United States, 'JP' for Japan) for which you want trending searches. This field overrides the general 'Geo Location' for these specific search types.", "default": "US" }, "hostLanguage": { "title": "Host Language (hl)", "type": "string", "description": "Interface language code, e.g. 'en-US'. Default is 'en-US'.", "default": "en-US" }, "proxies": { "title": "Custom Proxies", "type": "array", "description": "Optional list of proxy URLs if you don't want to use Apify proxy.", "items": { "type": "string" } }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Use Apify Residential Proxy for cloud runs. Local runs connect directly unless you provide a custom proxy.", "default": true }, "newsTokens": { "title": "Trending News Tokens", "type": "array", "description": "Required when Search Type = 'trendingNowNews'. Tokens come from trending_now().", "items": { "type": "string" } }, "maxNews": { "title": "Max News per Topic", "type": "integer", "description": "Maximum number of news articles to fetch (trendingNowNews). Default 3.", "default": 3 }, "batchPeriod": { "title": "Batch Period", "enum": [ "Past4H", "Past24H", "Past48H", "Past7D" ], "type": "string", "description": "Select timeframe for showcase timeline (trendingNowShowcaseTimeline).", "default": "Past24H" }, "findText": { "title": "Search Term (categories/geo)", "type": "string", "description": "Text to look for when using 'categories' or 'geo' search types." } } }, "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 } } } } } } } } } }