{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper: Interest, Rising Queries & Trending Now",
"description": "Google Trends in one Actor: interest over time, by region and related queries for up to 5 compared terms, plus Trending Now (hundreds of trending searches per country, with volume, growth and related searches). Paced and IP-rotated so runs finish.",
"version": "0.1",
"x-build-id": "BrO5O0nR0EUS5RuVn"
},
"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 up to 5 terms in one report by separating them with commas, e.g. coffee, tea. 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."
},
"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
}
}
}
}
}
}
}
}
}
}