{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper: Interest, Related and Trending Now", "description": "Google Trends scraper for search terms and comparisons: interest over time, interest by region, related queries, plus the full Trending now list per country. Batch up to 2,000 queries, no charge for empty results.", "version": "0.1", "x-build-id": "3l05V0mfGPc36omiP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/agenttoolworks~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-agenttoolworks-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/agenttoolworks~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-agenttoolworks-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/agenttoolworks~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-agenttoolworks-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 read", "enum": [ "explore", "trendingNow" ], "type": "string", "description": "Explore: interest over time, by region and related queries for your search terms and comparisons (one row per term or comparison). Trending now: the full list of searches trending in a country (one row per trending search).", "default": "explore" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "One term per line, each read on its own (one row each). A Google Trends topic ID such as /m/02vqfm works too. Up to 2,000 queries per run.", "items": { "type": "string" } }, "comparisons": { "title": "Comparisons", "type": "array", "description": "2 to 5 terms separated by commas per line, compared on one 0-100 scale as on the Google Trends page (one row per line).", "items": { "type": "string" } }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Explore page URLs (https://trends.google.com/trends/explore?q=...). Each keeps its own terms, geo, date, category and property; settings it does not carry come from the fields below.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "geo": { "title": "Location", "type": "string", "description": "Empty for worldwide, a country code (US, FR), a region (US-CA) or a US metro (US-CA-807).", "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": "As on the Google Trends page. Google picks the bucket: minutes for 1 and 4 hours, hours for 1 and 7 days, days up to 3 months, weeks for 12 months and 5 years, months since 2004.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "\"YYYY-MM-DD YYYY-MM-DD\" (e.g. 2024-01-01 2024-12-31), from 2004-01-01. Overrides Time range." }, "category": { "title": "Category", "minimum": 0, "type": "integer", "description": "Google Trends category ID, 0 for all categories (e.g. 71 Food & Drink, 5 Computers & Electronics, 7 Finance). The ID is the cat= parameter of a Google Trends URL.", "default": 0 }, "property": { "title": "Search type", "enum": [ "web", "images", "news", "youtube", "shopping" ], "type": "string", "description": "Which Google search the interest is measured on.", "default": "web" }, "sections": { "title": "Data to read", "type": "array", "description": "Each section is part of the same row and the same price. Related topics: Google shows logged-out visitors an empty related-topics panel for most queries, so it is off by default; when Google sends topics, they are returned.", "items": { "type": "string", "enum": [ "interestOverTime", "interestByRegion", "relatedQueries", "relatedTopics" ], "enumTitles": [ "Interest over time", "Interest by region", "Related queries (top and rising)", "Related topics (top and rising)" ] }, "default": [ "interestOverTime", "interestByRegion", "relatedQueries" ] }, "regionResolution": { "title": "Region level", "enum": [ "", "COUNTRY", "REGION", "DMA", "CITY" ], "type": "string", "description": "Empty lets Google choose (countries worldwide, regions inside a country). Metro areas (DMA) exist for the US only.", "default": "" }, "includeLowVolumeRegions": { "title": "Include low-volume regions", "type": "boolean", "description": "Google's own checkbox: also list regions with little search volume.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Language of Google's labels (dates, region and topic names), e.g. en-US, fr, de.", "default": "en-US" }, "timezoneOffsetMinutes": { "title": "Time zone offset (minutes)", "minimum": -840, "maximum": 840, "type": "integer", "description": "Offset from UTC for hourly and daily buckets: 0 is UTC, 60 is UTC+1, -300 is UTC-5.", "default": 0 }, "trendingGeos": { "title": "Trending now: countries", "type": "array", "description": "Trending now mode. Country codes (US, GB, FR) or regions (US-CA), one list each.", "default": [ "US" ], "items": { "type": "string" } }, "trendingHours": { "title": "Trending now: window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "Trending now mode. As the page's filter.", "default": "24" }, "trendingCategories": { "title": "Trending now: categories", "type": "array", "description": "Trending now mode. Keep only these categories; empty keeps all.", "items": { "type": "string", "enum": [ "1", "2", "3", "20", "4", "5", "6", "7", "8", "9", "10", "11", "13", "14", "15", "16", "17", "18", "19" ], "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": [] }, "trendingActiveOnly": { "title": "Trending now: active only", "type": "boolean", "description": "Trending now mode. Keep only searches still trending (the page's \"Active\" filter).", "default": false }, "maxTrendingPerGeo": { "title": "Trending now: maximum per country", "minimum": 0, "type": "integer", "description": "Trending now mode. 0 returns the whole list (446 searches for the US over 24 hours on 2026-10-05). Rows come in Google's own order.", "default": 0 }, "proxy": { "title": "Proxy", "enum": [ "auto", "datacenter", "residential", "none" ], "type": "string", "description": "Auto: Apify datacenter IPs, one per parallel session; when Google rate-limits them twice in a row, the session moves to residential IPs for a while. Google rate-limits single IPs quickly, so No proxy is slow and suited to a few queries.", "default": "auto" } } }, "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 } } } } } } } } } }