{ "openapi": "3.0.1", "info": { "title": "TrendSnap: Fast Google Trends Scraper & API", "description": "TrendSnap is a fast Google Trends API alternative. Bulk keywords, compare up to 5 terms, interest over time, by region and city, related queries (top + rising), and trending searches by country. No browser, so lookups take seconds.", "version": "0.1", "x-build-id": "FFhk9hb98XuoHJaSS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/spidyshivam~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-spidyshivam-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/spidyshivam~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-spidyshivam-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/spidyshivam~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-spidyshivam-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. Each line is one chart. Put up to 5 terms on one line separated by commas to compare them against each other, e.g. \"chatgpt, claude, gemini\".", "items": { "type": "string" } }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Optional. Paste explore URLs straight from trends.google.com; their own terms, region, dates, category and search type are used.", "items": { "type": "string" } }, "geo": { "title": "Region", "type": "string", "description": "Country or region code, e.g. US, IN, GB, or US-CA for California. 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 look at. Ignored when a custom time range is set.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Optional. Exact dates as \"YYYY-MM-DD YYYY-MM-DD\", e.g. \"2025-01-01 2025-12-31\". Overrides the time range above." }, "category": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Google Trends category ID, e.g. 0 = all, 7 = Finance, 13 = Computers & Electronics, 71 = Food & Drink. Find IDs in the cat= part of a Trends URL.", "default": 0 }, "searchType": { "title": "Search type", "enum": [ "", "images", "news", "froogle", "youtube" ], "type": "string", "description": "Which Google property to measure.", "default": "" }, "includeInterestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Where the terms are most popular.", "default": true }, "regionResolution": { "title": "Region detail", "enum": [ "", "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Granularity of interest by region. Leave on default to match the Trends website.", "default": "" }, "includeLowSearchVolume": { "title": "Include low search volume regions", "type": "boolean", "description": "Also return regions with little search volume.", "default": false }, "includeRelatedQueries": { "title": "Related queries", "type": "boolean", "description": "Top and rising searches related to each term.", "default": true }, "trendingNowCountries": { "title": "Countries or regions", "type": "array", "description": "Get what is trending in Google Search right now: hundreds of trends per country with search volume, growth, categories, related searches and news links. Use two-letter codes (US, IN, GB) or regions (US-CA, IN-MH).", "items": { "type": "string" } }, "trendingHours": { "title": "Time window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "How far back to look for trending searches.", "default": "24" }, "trendingCategories": { "title": "Categories", "type": "array", "description": "Only keep trends in these categories. Leave empty for all categories.", "items": { "type": "string", "enum": [ "Autos and Vehicles", "Beauty and Fashion", "Business and Finance", "Climate", "Entertainment", "Food and Drink", "Games", "Health", "Hobbies and Leisure", "Jobs and Education", "Law and Government", "Other", "Pets and Animals", "Politics", "Science", "Shopping", "Sports", "Technology", "Travel and Transportation" ] } }, "trendingActiveOnly": { "title": "Active trends only", "type": "boolean", "description": "Skip trends that have already ended.", "default": false }, "trendingSortBy": { "title": "Sort by", "enum": [ "relevance", "searchVolume", "increase", "recency" ], "type": "string", "description": "Order of the trending searches.", "default": "relevance" }, "trendingMaxItems": { "title": "Max trends per country", "minimum": 0, "type": "integer", "description": "Limit the number of trends returned per country. 0 means all.", "default": 0 }, "trendingIncludeNews": { "title": "Include news links", "type": "boolean", "description": "Attach news articles to the top trends (Google publishes them only for the biggest trends).", "default": true }, "maxConcurrency": { "title": "Parallel sessions", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many requests to run at once. Higher is faster for long keyword lists.", "default": 3 }, "maxRetries": { "title": "Max retries", "minimum": 0, "maximum": 15, "type": "integer", "description": "How many times to retry a request from a fresh IP when Google blocks it.", "default": 6 }, "failOnNoResults": { "title": "Fail if nothing is found", "type": "boolean", "description": "Mark the run as failed when no lookup returns data. Useful for scheduled monitoring runs with a keyword that always has data.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxies give the most reliable results with Google. US IPs avoid cookie-consent pages; the region you query is set by the Region field, not by the proxy country.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }