{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper: Unlimited Keywords + Daily Data",
"description": "Google Trends without its limits: compare up to 100 keywords on one 0-100 scale (Google stops at 5), and daily data for any range, even 5 years or 2004-now (Google gives weekly/monthly). Plus regions, related queries and Trending Now. Paced so runs finish.",
"version": "0.2",
"x-build-id": "0JUQAn3ZTpWCwg6UJ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/wulfcare~google-trends-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-wulfcare-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/wulfcare~google-trends-scraper/runs": {
"post": {
"operationId": "runs-sync-wulfcare-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/wulfcare~google-trends-scraper/run-sync": {
"post": {
"operationId": "run-sync-wulfcare-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 scrape",
"enum": [
"explore",
"trendingNow"
],
"type": "string",
"description": "Explore gives interest over time, by region and related queries for your search terms. Trending Now lists every search trending in the countries you pick.",
"default": "explore"
},
"searchTerms": {
"title": "Search terms",
"type": "array",
"description": "One report per line. Compare terms by separating them with commas, e.g. coffee, tea. No 5-term limit: put up to 100 terms on one line and they all come back on one 0-100 scale (Google itself compares only 5; we chain overlapping groups, charged per Google query used). You can also paste a Google Trends explore URL, and its terms, country, time range and category are used as-is.",
"items": {
"type": "string"
}
},
"geo": {
"title": "Country or region",
"type": "string",
"description": "ISO country code like US, AU, GB, or a region like US-CA. Leave empty for worldwide.",
"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": "Period to analyse. Google picks the resolution: minutes for the past hour or 4 hours, hours for 7 days, days up to 90 days, weeks up to 5 years, and months since 2004.",
"default": "today 12-m"
},
"customTimeRange": {
"title": "Custom time range (optional)",
"type": "string",
"description": "Overrides the time range above. Format YYYY-MM-DD YYYY-MM-DD, e.g. 2024-01-01 2024-06-30."
},
"dailyData": {
"title": "Daily data for any time range",
"type": "boolean",
"description": "Google only gives daily points for ranges under ~9 months, then weekly or monthly. Turn this on to get daily points for the whole range (12 months, 5 years, even 2004 to now): we fetch ~8-month daily windows and scale each one to Google's full-range series. Each window is one more Google query, charged as a report (5 years ≈ 10 reports). Up to 5 terms per line.",
"default": false
},
"category": {
"title": "Category ID",
"type": "integer",
"description": "Google Trends category, e.g. 0 = all, 71 = Food & Drink, 7 = Finance. Default 0.",
"default": 0
},
"searchProperty": {
"title": "Search type",
"enum": [
"",
"images",
"news",
"froogle",
"youtube"
],
"type": "string",
"description": "Which Google search to measure: web (default), images, news, Google Shopping or YouTube.",
"default": ""
},
"interestOverTime": {
"title": "Interest over time",
"type": "boolean",
"description": "Relative search interest (0-100) over the chosen time range.",
"default": true
},
"interestByRegion": {
"title": "Interest by region",
"type": "boolean",
"description": "Relative search interest (0-100) by country, region, city or US metro area.",
"default": true
},
"relatedQueries": {
"title": "Related queries (top + rising)",
"type": "boolean",
"description": "The top and rising searches related to each term, including \"Breakout\" queries (growth over 5,000%).",
"default": true
},
"regionResolution": {
"title": "Region resolution",
"enum": [
"",
"COUNTRY",
"REGION",
"CITY",
"DMA"
],
"type": "string",
"description": "Level of detail for interest by region. \"Google default\" uses countries for worldwide and regions within a country.",
"default": ""
},
"includeLowVolumeRegions": {
"title": "Include low search volume regions",
"type": "boolean",
"description": "Include regions with too little search volume for Google to rate reliably (they usually show 0).",
"default": false
},
"saveCsv": {
"title": "Also save spreadsheet-friendly CSVs",
"type": "boolean",
"description": "Saves interest_over_time.csv, interest_by_region.csv and related_queries.csv (one row per value) to the run's key-value store for Excel or Google Sheets. Free.",
"default": true
},
"trendingGeos": {
"title": "Countries or regions",
"type": "array",
"description": "ISO codes like US, GB, AU, or regions like US-CA. One set of trends per entry.",
"items": {
"type": "string"
}
},
"trendingHours": {
"title": "Time window",
"enum": [
"4",
"24",
"48",
"168"
],
"type": "string",
"description": "How far back to look for trending searches.",
"default": "24"
},
"trendingCategories": {
"title": "Only these categories (optional)",
"type": "array",
"description": "Leave empty for all categories.",
"items": {
"type": "string",
"enum": [
"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"
]
}
},
"trendingActiveOnly": {
"title": "Only trends that are still active",
"type": "boolean",
"description": "Skip trends that have already ended.",
"default": false
},
"maxTrendsPerGeo": {
"title": "Max trends per country (0 = all)",
"minimum": 0,
"type": "integer",
"description": "Trends are sorted by search volume, highest first.",
"default": 0
},
"language": {
"title": "Interface language",
"type": "string",
"description": "Language of Google's labels and related queries, e.g. en-US, en-GB, de, ja.",
"default": "en-US"
},
"timezoneOffsetMinutes": {
"title": "Timezone offset (minutes)",
"type": "integer",
"description": "Google's tz parameter: minutes WEST of UTC (Sydney = -600, New York = 300).",
"default": 0
},
"maxConcurrency": {
"title": "Parallel reports",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "How many reports run at once, each on its own IP. Only applies when using a proxy.",
"default": 3
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Residential proxies are strongly recommended: Google rate-limits datacenter IPs hard.",
"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
}
}
}
}
}
}
}
}
}
}