{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper API", "description": "Compare Google Trends keywords for SEO and seasonal research. Export relative interest over time, interest by region, related queries and trending searches to CSV or JSON. Choose your country and date range. Maintained by CleanScrape.", "version": "0.3", "x-build-id": "Qma5iTYDTQNYhOv9v" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cleanscrape~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cleanscrape-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/cleanscrape~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-cleanscrape-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/cleanscrape~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-cleanscrape-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Up to five terms to compare, one per line. A comma also separates terms. Not needed for Trending now.", "items": { "type": "string" } }, "dataTypes": { "title": "Results to collect", "type": "array", "description": "Interest over time gives the chart you see on Google Trends. Each other choice adds its own rows to the export.", "items": { "type": "string", "enum": [ "interest_over_time", "related_queries", "related_topics", "interest_by_region", "trending_now" ], "enumTitles": [ "Interest over time", "Related and rising queries", "Related topics (limited availability)", "Interest by region", "Trending now" ] }, "default": [ "interest_over_time", "trending_now" ] }, "geo": { "title": "Country", "type": "string", "description": "Where the searches were made. Choose Worldwide for all countries.", "default": "" }, "timeframe": { "title": "Time range", "type": "string", "description": "How far back to look. Not used if you pick custom dates below.", "default": "today 12-m" }, "trendingGeo": { "title": "Country for Trending now", "type": "string", "description": "Only used for Trending now.", "default": "US" }, "startDate": { "title": "Start date (optional)", "type": "string", "description": "Use your own dates instead of Time range. Without an end date, the range runs to today." }, "endDate": { "title": "End date (optional)", "type": "string", "description": "Leave empty to go up to today." }, "category": { "title": "Category (optional)", "type": "integer", "description": "A Google Trends category number, or 0 for all. For example 71 Food & Drink, 18 Shopping, 7 Finance, 5 Computers & Electronics, 45 Health, 20 Sports or 67 Travel.", "default": 0 }, "regionResolution": { "title": "Region detail", "enum": [ "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Used for Interest by region. Country compares countries in a worldwide search; with a country chosen, its regions are used instead. Metro areas (DMA) exist only for the United States.", "default": "COUNTRY" }, "language": { "title": "Language", "type": "string", "description": "Language of Google's own labels, such as topic names. Your search terms are not translated.", "default": "en-US" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave this as it is. Google Trends blocks repeated requests, and residential proxies avoid that. Their cost is included in the price.", "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 } } } } } } } } } }