{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper - Interest, Regions & Trending", "description": "Scrape Google Trends without login: interest over time, interest by country, state, city or metro, related queries (top and rising), keyword comparison and today's trending searches by country with news. Web, YouTube, News, Images or Shopping search.", "version": "0.1", "x-build-id": "QjGoCqAcARANQrEVw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapewise~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapewise-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/scrapewise~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-scrapewise-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/scrapewise~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-scrapewise-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 to analyze, one per line, for example artificial intelligence or chatgpt. Each keyword returns one report row, charged as 'Keyword report': interest over time (0 to 100) with a summary (average, peak, latest value, change), interest by region and related queries, as set in 'Report sections'.", "items": { "type": "string" } }, "geo": { "title": "Location", "type": "string", "description": "Where the searches come from: a country code (US, BR, GB, IN...) or a region code (US-CA, BR-SP, GB-ENG). Empty = worldwide." }, "timeframe": { "title": "Time range", "enum": [ "past_hour", "past_4_hours", "past_day", "past_7_days", "past_30_days", "past_90_days", "past_12_months", "past_5_years", "since_2004" ], "type": "string", "description": "Period of the interest data, from the past hour to since 2004 (the select options). Through the API you can also send a custom range as 'YYYY-MM-DD YYYY-MM-DD', for example '2026-01-01 2026-06-30'. Short periods come hourly or by the minute, long ones weekly or monthly, as Google decides.", "default": "past_12_months" }, "compareKeywords": { "title": "Compare keywords with each other", "type": "boolean", "description": "Off (default): each keyword is scaled on its own, so its peak is 100. On: up to 5 keywords share one chart, as on the Google Trends site, so their values are relative to each other and you can see which is searched more.", "default": false }, "searchProperty": { "title": "Search type", "enum": [ "web", "youtube", "news", "images", "shopping" ], "type": "string", "description": "Which Google search the interest comes from: Web search (default), YouTube search, News search, Image search or Google Shopping.", "default": "web" }, "category": { "title": "Category id", "type": "integer", "description": "Google Trends category id to narrow an ambiguous keyword, for example 0 = all categories (default), 7 = Finance, 18 = Shopping, 71 = Food & Drink, 174 = Sports. The id is the 'cat=' number in a Google Trends link.", "default": 0 }, "includeRegions": { "title": "Interest by region", "type": "boolean", "description": "On (default): adds interest by region to each keyword report, at the level chosen below. Turn off for faster runs when you only need the time series.", "default": true }, "regionResolution": { "title": "Region level", "enum": [ "country", "region", "city", "metro" ], "type": "string", "description": "Detail of the regional breakdown: Countries, States or regions, Cities, or Metro areas (US only). Empty lets Google pick: countries for worldwide, states inside a country." }, "includeRelated": { "title": "Related queries", "type": "boolean", "description": "On (default): adds the top and rising related queries, and related topics when Google serves them. Useful to find new keyword ideas. Turn off for faster runs.", "default": true }, "trendingCountries": { "title": "Trending now (country codes)", "type": "array", "description": "Optional. Also return today's trending searches for these countries, one code per line, for example US, BR, GB, IN or DE. One row per trending search with approximate search volume, start time and news links, charged as 'Trending search'. Works with or without keywords.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is the default and recommended. When Google answers 'too many requests', the Actor waits and retries on its own, with no extra charge. Change it only to use your own proxies.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }