{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper - $1 / 1000 Searches", "description": "Scrape Google Trends for any term or compare up to 5: interest over time, interest by country, region, city or metro, and top and rising related queries and topics. Any country, time range, category and Google property (web, images, news, YouTube, shopping). $1 per 1000 searches.", "version": "0.1", "x-build-id": "raYLTlKQwPdT0zJ3i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeunblocker~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeunblocker-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/scrapeunblocker~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-scrapeunblocker-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/scrapeunblocker~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeunblocker-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": { "search_terms": { "title": "Search terms", "type": "array", "description": "One search per line. A line is a single term (\"web scraping\") or up to 5 comma-separated terms to compare on one chart (\"coffee,tea,matcha\"). A Knowledge Graph topic ID such as /m/0dl567 also works.", "default": [ "web scraping" ], "items": { "type": "string" } }, "geo": { "title": "Location", "type": "string", "description": "Empty = worldwide. An ISO-2 country (US, DE), a region (US-CA) or a US metro (US-CA-807).", "default": "" }, "timeframe": { "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": "Time range of the search.", "default": "today 12-m" }, "custom_time_range": { "title": "Custom time range", "type": "string", "description": "Optional, overrides the time range: 'YYYY-MM-DD YYYY-MM-DD' (e.g. '2025-01-01 2025-06-30'), or hourly within the last 7 days: 'YYYY-MM-DDTHH YYYY-MM-DDTHH'." }, "property": { "title": "Google property", "enum": [ "web", "images", "news", "youtube", "shopping" ], "type": "string", "description": "Which Google search to measure.", "default": "web" }, "category": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Google Trends category ID (0 = all categories, 71 = Food & Drink, 5 = Computers & Electronics, ...).", "default": 0 }, "interest_by_region": { "title": "Interest by region", "type": "boolean", "description": "Include the interest-by-region map.", "default": true }, "related_queries": { "title": "Related queries", "type": "boolean", "description": "Include top and rising related queries for each term.", "default": true }, "related_topics": { "title": "Related topics", "type": "boolean", "description": "Include top and rising related topics for each term (Google often returns this list empty).", "default": false }, "region_resolution": { "title": "Region level", "enum": [ "auto", "country", "region", "city", "dma" ], "type": "string", "description": "Level of the interest-by-region map.", "default": "auto" }, "include_low_volume": { "title": "Include low-volume regions", "type": "boolean", "description": "Also list regions with low search volume.", "default": false }, "hl": { "title": "Language", "type": "string", "description": "Language of labels such as region names and topic titles (en-US, de, fr, ...).", "default": "en-US" }, "tz": { "title": "Timezone offset (minutes)", "minimum": -840, "maximum": 840, "type": "integer", "description": "Timezone that day and hour buckets align to, in Google's convention: 300 = UTC-5, -60 = UTC+1. Default 0 = UTC.", "default": 0 }, "proxy_country": { "title": "Exit country (optional)", "type": "string", "description": "ISO-2 exit country. Leave empty - the service picks the best exits itself, and results follow the Location field, not the exit.", "default": "" }, "concurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 2, "type": "integer", "description": "How many searches to run at the same time (1-2).", "default": 1 } } }, "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 } } } } } } } } } }