{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Google Trends data as JSON: interest over time, by country, state, metro or city, top and rising related queries, plus Trending Now searches with volume, growth and news. Compare up to 5 terms, paste Trends URLs, run hundreds of keywords. No browser, fast. Pay only for results.", "version": "1.0", "x-build-id": "JMhoizWCMbRynl04I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-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/axlymxp~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-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/axlymxp~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-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": { "mode": { "title": "What to scrape", "enum": [ "explore", "trendingNow" ], "type": "string", "description": "Explore returns one row per search term. Trending now returns one row per trending search.", "default": "explore" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords or topic ids (like /m/02vqfm). Each term is one row. Explore mode.", "items": { "type": "string" } }, "compareTerms": { "title": "Compare terms on one scale", "type": "boolean", "description": "On: terms are compared in groups of up to 5 (values are relative across the group, like the Trends compare view). Off: every term is scraped on its own 0-100 scale.", "default": false }, "startUrls": { "title": "Google Trends explore URLs", "type": "array", "description": "Paste trends.google.com/trends/explore?... URLs. Their own terms, geo, date, category and property are used.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "geo": { "title": "Location", "type": "string", "description": "Empty = worldwide. Country code (US, GB, DE), region (US-CA, GB-ENG) or US metro (US-NY-501).", "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", "custom" ], "type": "string", "description": "Data resolution follows Google: minutes, hours, days, weeks or months.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Used when Time range = Custom. Format: 2024-01-01 2024-12-31" }, "category": { "title": "Category id", "minimum": 0, "type": "integer", "description": "Google Trends category id, 0 = all categories (for example 71 = Food & Drink, 12 = Business & Industrial, 958 = Shopping).", "default": 0 }, "property": { "title": "Google property", "enum": [ "web", "youtube", "news", "images", "shopping" ], "type": "string", "description": "Which Google search to measure, as in the Trends property filter.", "default": "web" }, "includeInterestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Time series of search interest (0-100) for each term.", "default": true }, "includeInterestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Search interest per country, region, metro or city.", "default": true }, "regionResolution": { "title": "Region level", "enum": [ "auto", "COUNTRY", "REGION", "DMA", "CITY" ], "type": "string", "description": "Geographic level for interest by region.", "default": "auto" }, "includeLowVolumeRegions": { "title": "Include low-volume regions", "type": "boolean", "description": "Also return regions where Google has too little data (value 0).", "default": false }, "includeRelatedQueries": { "title": "Related queries (top + rising)", "type": "boolean", "description": "Top and rising (breakout) related search queries for each term.", "default": true }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run in parallel.", "default": 3 }, "trendingGeos": { "title": "Trending now: locations", "type": "array", "description": "Country (US, GB, IN) or region (US-CA) codes. Trending now mode.", "items": { "type": "string" } }, "trendingHours": { "title": "Trending now: time window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Time window of the trending list.", "default": "24" }, "trendingSort": { "title": "Trending now: sort", "enum": [ "relevance", "searchVolume", "recency" ], "type": "string", "description": "Order of the trending list before Max trending searches is applied.", "default": "relevance" }, "trendingCategories": { "title": "Trending now: categories", "type": "array", "description": "Empty = 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" ] } }, "onlyActiveTrends": { "title": "Only active trends", "type": "boolean", "description": "Skip trends that already ended.", "default": false }, "maxTrends": { "title": "Max trending searches per location", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper limit of trending searches returned per location (you pay per row).", "default": 100 }, "includeTrendNews": { "title": "Add news articles to each trend", "type": "boolean", "description": "Up to 3 headlines with source and link per trend (one extra request per trend).", "default": false }, "language": { "title": "Language", "type": "string", "description": "Interface language for labels and Trending now (en-US, de, fr, ja ...).", "default": "en-US" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Requests go direct first. When Google rate-limits an IP (HTTP 429) the run switches to a new proxy session. Residential works best; Google throttles shared datacenter IPs.", "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 } } } } } } } } } }