{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper — Compare Unlimited Keywords", "description": "Google Trends as spreadsheet-ready rows: interest over time, regions, related queries, trending now. Compare more than 5 keywords on one scale. $0.50/1K rows.", "version": "0.2", "x-build-id": "75pSOvSLcPRiyvABM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sondalabs~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sondalabs-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/sondalabs~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-sondalabs-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/sondalabs~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-sondalabs-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Search terms or topic IDs (e.g. /m/0dl567). Any number: more than 5 are compared on one scale through an anchor keyword.", "default": [ "chatgpt" ], "items": { "type": "string" } }, "anchorKeyword": { "title": "Anchor keyword", "type": "string", "description": "Keyword used to link batches when comparing more than 5. Leave empty to pick the strongest keyword of the first batch automatically." }, "dataTypes": { "title": "Data types", "type": "array", "description": "What to extract.", "items": { "type": "string", "enum": [ "interest_over_time", "interest_by_region", "related_queries", "related_topics", "trending_now" ], "enumTitles": [ "Interest over time", "Interest by region", "Related queries", "Related topics", "Trending now" ] }, "default": [ "interest_over_time" ] }, "geo": { "title": "Location", "pattern": "^([A-Z]{2}(-[A-Z0-9]{1,3})?)?$", "type": "string", "description": "Country (US) or region (US-CA). Leave empty for worldwide.", "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": "Period to analyze. Short periods return finer granularity (hourly, daily); longer ones weekly or monthly.", "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": "Exact range, e.g. 2024-01-01 2025-06-30. Overrides Time range." }, "dailyHistory": { "title": "Daily history for long ranges", "type": "boolean", "description": "Return daily values for ranges longer than Google allows (about 260 days) by stitching overlapping windows into one consistent series. Uses roughly one request per 200 days per keyword batch, and returns about one row per keyword per day: set maxRows accordingly.", "default": false }, "property": { "title": "Search type", "enum": [ "web", "youtube", "news", "images", "froogle" ], "type": "string", "description": "Which Google search product to measure.", "default": "web" }, "category": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Google Trends category ID. 0 = all categories.", "default": 0 }, "regionResolution": { "title": "Region detail", "enum": [ "auto", "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Level of detail for interest by region. Automatic picks countries for worldwide and regions/states for a single country.", "default": "auto" }, "trendingGeo": { "title": "Trending now: country", "pattern": "^[A-Z]{2}$", "type": "string", "description": "Two-letter country code for Trending now, e.g. US or MX.", "default": "US" }, "trendingHours": { "title": "Trending now: period", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "How far back Trending now looks.", "default": "24" }, "maxRows": { "title": "Max rows per run", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on billable rows for the whole run. The run stops cleanly when reached.", "default": 5000 }, "skipEmptyRows": { "title": "Skip rows without data", "type": "boolean", "description": "Google sometimes has no data for a point (for example small cities). Those rows are never charged. When enabled they are left out of the dataset; disable to keep them with value null.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Keep residential proxies: Google Trends rate-limits datacenter IPs almost immediately.", "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 } } } } } } } } } }