{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper API - Trending Now & Rising Queries", "description": "Google Trends API: interest over time with growth %, by country/state/city, rising & breakout queries, full Trending Now list with search volume & news. Rank unlimited keywords on one scale, many countries per run. Fast, no browser; empty results never charged.", "version": "1.0", "x-build-id": "JELiEYPixBmIsJB4v" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/victorrodi~google-trends-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-victorrodi-google-trends-api", "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/victorrodi~google-trends-api/runs": { "post": { "operationId": "runs-sync-victorrodi-google-trends-api", "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/victorrodi~google-trends-api/run-sync": { "post": { "operationId": "run-sync-victorrodi-google-trends-api", "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": "One query per line. Put up to 5 terms on one line, separated by commas, to compare them on the same scale (e.g. 'iphone, samsung, pixel'). The two example lines are skipped automatically when you only ask for Trending now or Google Trends URLs, so you never pay for them.", "default": [ "pokemon cards", "iphone, samsung, pixel" ], "items": { "type": "string" } }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Optional. Paste trends.google.com/trends/explore URLs straight from your browser: terms, location, period, category and search type are read from the URL.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "geo": { "title": "Location", "type": "string", "description": "Country or region code: 'US', 'PT', 'GB', 'US-CA', 'BR-SP'… Leave empty for Worldwide.", "default": "" }, "geos": { "title": "Several locations (optional)", "type": "array", "description": "Run every query for each of these locations, e.g. 'US', 'GB', 'DE', 'FR'. Overrides 'Location'. Great to compare markets.", "default": [], "items": { "type": "string" } }, "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 analyse. Ignored if 'Custom time range' is filled.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "pattern": "^(\\d{4}-\\d{2}-\\d{2} \\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional, overrides Time range. Format: 'YYYY-MM-DD YYYY-MM-DD', e.g. '2024-01-01 2024-06-30'." }, "dataTypes": { "title": "Data to extract", "type": "array", "description": "Each selected block is one result in the dataset (related queries: one result per compared term). Blocks without data are skipped and never charged.", "items": { "type": "string", "enum": [ "interestOverTime", "interestByRegion", "relatedQueries" ], "enumTitles": [ "Interest over time", "Interest by region", "Related queries (top + rising)" ] }, "default": [ "interestOverTime", "interestByRegion", "relatedQueries" ] }, "keywordRanking": { "title": "Rank all terms on one scale (beyond 5)", "type": "boolean", "description": "Google compares only 5 terms at once. Turn this on to rank ANY number of terms on one common 0-100 scale (anchor-term method). You can then put as many comma-separated terms as you like on one line. Adds one 'keywordRanking' result.", "default": false }, "anchorTerm": { "title": "Anchor term for ranking", "type": "string", "description": "Optional. A popular term shared by every batch to link them. Defaults to your first term; pick one with steady volume.", "default": "" }, "category": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Google Trends category ID. 0 = all categories. Examples: 7 Finance, 18 Shopping, 20 Sports, 5 Computers & Electronics, 16 News, 71 Food & Drink, 8 Games.", "default": 0 }, "property": { "title": "Search type", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Which Google search the interest comes from: web, image, news, YouTube or Shopping.", "default": "" }, "regionResolution": { "title": "Region detail", "enum": [ "", "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Detail level for 'Interest by region'. Automatic = countries when Worldwide, regions inside a country.", "default": "" }, "includeLowVolumeRegions": { "title": "Include low search volume regions", "type": "boolean", "description": "Also return regions where search volume is too low for a stable index.", "default": false }, "trendingNowGeos": { "title": "Trending now: countries", "type": "array", "description": "Optional. Country codes (e.g. 'US', 'GB', 'PT'): get the full Trending Now list — hundreds of trends with search volume, growth %, start time, related queries, category and news links.", "items": { "type": "string" } }, "trendingNowHours": { "title": "Trending now: time window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Period of the Trending Now list.", "default": "24" }, "trendingNowCategories": { "title": "Trending now: categories", "type": "array", "description": "Optional. Keep only trends in these categories (Sports, Technology, Shopping…). Empty = all.", "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" ], "enumTitles": [ "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" ] }, "default": [] }, "trendingNowMaxItems": { "title": "Trending now: max trends per country", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Biggest search volume first. Caps the cost: each trend is one result.", "default": 50 }, "trendingNowActiveOnly": { "title": "Trending now: active trends only", "type": "boolean", "description": "Skip trends that have already ended.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Interface language for topic names, e.g. 'en-US', 'pt-PT', 'fr', 'de', 'es'.", "default": "en-US" }, "maxRetries": { "title": "Max retries per request", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many times a blocked request is retried with a new IP before the query is reported as failed.", "default": 6 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is used by default. If Google blocks, the Actor switches to residential IPs automatically.", "default": { "useApifyProxy": true } }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Log every request (status, proxy type). Useful only for troubleshooting.", "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 }, "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 } } } } } } } } } }