{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper with Top and Rising Searches", "description": "Google Trends Scraper extracts trending search data from Google Trends. It collects keywords, interest over time, related queries, regional popularity, and trend metrics. Ideal for SEO research, market analysis, content planning, and monitoring emerging search trends.", "version": "0.1", "x-build-id": "xJA5e0zE7urx7Wa26" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapebase~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapebase-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/scrapebase~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-scrapebase-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/scrapebase~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-scrapebase-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": "πŸ“ Add the keywords or topics you want to analyze. Required if you do not provide a Google Sheet ID.", "items": { "type": "string" } }, "isMultiple": { "title": "🧩 Multiple terms mode", "type": "boolean", "description": "βœ… Enable this if commas in a line should split into multiple terms.", "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": "πŸ“… Choose how far back to analyze trend history (default: Past 12 months).", "default": "today 12-m" }, "geo": { "title": "🌍 Geo area", "enum": [ "", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "πŸ—ΊοΈ Select a country/region to localize trend data. Leave empty for Worldwide results. If you provide Google Trends URLs, location settings inside those URLs will be used first.", "default": "" }, "viewedFrom": { "title": "🏠 Viewed from country", "enum": [ "", "us", "af", "al", "dz", "as", "ad", "ao", "ai", "aq", "ag", "ar", "am", "aw", "au", "at", "az", "bs", "bh", "bd", "bb", "by", "be", "bz", "bj", "bm", "bt", "bo", "ba", "bw", "bv", "br", "io", "bn", "bg", "bf", "bi", "kh", "cm", "ca", "cv", "ky", "cf", "td", "cl", "cn", "cx", "cc", "co", "km", "cg", "cd", "ck", "cr", "ci", "hr", "cu", "cy", "cz", "dk", "dj", "dm", "do", "ec", "eg", "sv", "gq", "er", "ee", "et", "fk", "fo", "fj", "fi", "fr", "gf", "pf", "tf", "ga", "gm", "ge", "de", "gh", "gi", "gr", "gl", "gd", "gp", "gu", "gt", "gn", "gw", "gy", "ht", "hm", "va", "hn", "hk", "hu", "is", "in", "id", "ir", "iq", "ie", "il", "it", "jm", "jp", "jo", "kz", "ke", "ki", "kp", "kr", "kw", "kg", "la", "lv", "lb", "ls", "lr", "ly", "li", "lt", "lu", "mo", "mk", "mg", "mw", "my", "mv", "ml", "mt", "mh", "mq", "mr", "mu", "yt", "mx", "fm", "md", "mc", "mn", "me", "ms", "ma", "mz", "mm", "na", "nr", "np", "nl", "an", "nc", "nz", "ni", "ne", "ng", "nu", "nf", "mp", "no", "om", "pk", "pw", "ps", "pa", "pg", "py", "pe", "ph", "pn", "pl", "pt", "pr", "qa", "re", "ro", "ru", "rw", "sh", "kn", "lc", "pm", "vc", "ws", "sm", "st", "sa", "sn", "rs", "sc", "sl", "sg", "sk", "si", "sb", "so", "za", "gs", "ss", "es", "lk", "sd", "sr", "sj", "sz", "se", "ch", "sy", "tw", "tj", "tz", "th", "tl", "tg", "tk", "to", "tt", "tn", "tr", "tm", "tc", "tv", "ug", "ua", "ae", "gb", "um", "uy", "uz", "vu", "ve", "vn", "vg", "vi", "wf", "eh", "ye", "zm", "zw" ], "type": "string", "description": "🌐 Choose the country context used when viewing Trends pages to help match local results.", "default": "" }, "skipDebugScreen": { "title": "πŸ–ΌοΈ Do not save snapshots", "type": "boolean", "description": "πŸ’Ύ By default, page snapshots are saved for debugging. Turn this on to skip saving snapshots.", "default": false }, "startUrls": { "title": "πŸ”— Google Trends URLs", "type": "array", "description": "🎯 Paste full Google Trends URLs when you need custom comparisons, advanced filters, or exact date windows.", "items": { "type": "string" } }, "spreadsheetId": { "title": "πŸ“„ Google Sheet ID", "type": "string", "description": "πŸ“₯ Optional: load terms automatically from a public Google Sheet. Use one column only; row 1 is treated as a header.", "default": "" }, "category": { "title": "πŸ—‚οΈ Trend category", "enum": [ "", "3", "47", "44", "22", "12", "5", "7", "71", "8", "45", "65", "11", "13", "958", "19", "16", "299", "14", "66", "29", "533", "174", "18", "20", "67" ], "type": "string", "description": "πŸŽ›οΈ Narrow results to a specific Trends category, or leave empty for all categories.", "default": "" }, "maxItems": { "title": "πŸ”’ Max items", "minimum": 0, "type": "integer", "description": "πŸ“¦ Maximum number of output records. Use 0 for no limit.", "default": 0 }, "customTimeRange": { "title": "πŸ•’ Custom time range", "type": "string", "description": "🧭 Set an exact date range in this format: YYYY-MM-DD YYYY-MM-DD. This overrides the preset time range.", "default": "" }, "maxConcurrency": { "title": "⚑ Max concurrency", "minimum": 1, "type": "integer", "description": "🚦 Number of pages to process in parallel. Higher values can be faster but use more resources.", "default": 10 }, "maxRequestRetries": { "title": "πŸ” Max request retries", "minimum": 1, "type": "integer", "description": "πŸ›Ÿ Number of retry attempts for failed requests before giving up.", "default": 7 }, "pageLoadTimeoutSecs": { "title": "⏱️ Page load timeout", "minimum": 30, "type": "integer", "description": "βŒ› Maximum wait time for a page to load before retrying.", "default": 180 }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy configuration", "type": "object", "description": "🌍 Configure proxy usage for stable access. Useful when you need geo-consistent or more resilient requests." }, "includeRelatedQueries": { "title": "πŸ” Include related searches", "type": "boolean", "description": "πŸ“ˆ Pull the search phrases Google attaches to each keyword β€” the most-searched list and the fastest-growing list. This is what turns a trend line into a content brief.", "default": true }, "relatedQueriesType": { "title": "πŸ“Š Which list to return", "enum": [ "both", "top", "rising" ], "type": "string", "description": "🎯 Choose the most-searched phrases (top), the fastest-growing phrases (rising), or both. Rising is where 'Breakout' phrases show up.", "default": "both" }, "onlyBreakoutQueries": { "title": "πŸš€ Only Breakout phrases", "type": "boolean", "description": "πŸ’₯ Keep only the rising phrases Google itself labels \"Breakout\" (a jump too large for a percentage). Useful when you want tomorrow's topic, not this year's.", "default": false }, "maxRelatedQueries": { "title": "πŸ”’ Max phrases per list", "minimum": 1, "maximum": 25, "type": "integer", "description": "πŸ“¦ How many phrases to keep in each list. Google returns at most 25 per list, so 25 is the ceiling.", "default": 25 }, "includeRelatedTopics": { "title": "🧠 Also try related topics (best effort)", "type": "boolean", "description": "πŸ§ͺ Optionally also ask Google for related topics (entities rather than phrases). Google currently returns an empty topics list for automated requests, so this is off by default and may come back empty β€” the phrase lists above are the reliable deliverable.", "default": false } } }, "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 } } } } } } } } } }