{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper 📈 (results in seconds)",
"description": "Scrape Google Trends as clean JSON: interest over time, interest by region, related queries, keyword comparison and live Trending Now with real search volumes. No browser, no Puppeteer, no API key, just fast results for SEO research, market tracking and AI agents.",
"version": "0.1",
"x-build-id": "Cvtn5xYNVIl4JhQFa"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~google-trends-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-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/tagadanar~google-trends-scraper/runs": {
"post": {
"operationId": "runs-sync-tagadanar-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/tagadanar~google-trends-scraper/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-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": "Keywords to analyse. Each term returns one record with interest over time, interest by region and related queries/topics. Enable Compare terms to score up to 5 terms on a shared 0–100 scale.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Google Trends URLs",
"type": "array",
"description": "Paste trends.google.com/trends/explore?q=… URLs straight from your browser — the terms, location, date range, category and property are read from each URL (comma-separated q = compared terms).",
"items": {
"type": "string"
}
},
"spreadsheetId": {
"title": "Google Sheet ID (bulk terms)",
"type": "string",
"description": "ID of a public Google Sheet (\"anyone with the link\") whose first column lists search terms — for bulk jobs with hundreds of keywords. The ID is the long token in the sheet URL."
},
"compareTerms": {
"title": "Compare terms (shared 0–100 scale)",
"type": "boolean",
"description": "Score all search terms against each other in one comparison (max 5 terms), like adding terms on trends.google.com. Off = each term is scaled to its own peak.",
"default": false
},
"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 for interest-over-time.",
"default": "today 12-m"
},
"customTimeRange": {
"title": "Custom date range",
"type": "string",
"description": "Overrides the time range above. Format: YYYY-MM-DD YYYY-MM-DD (e.g. 2024-01-01 2024-06-30)."
},
"geo": {
"title": "Location",
"enum": [
"",
"US",
"GB",
"CA",
"AU",
"IE",
"NZ",
"IN",
"FR",
"DE",
"ES",
"IT",
"NL",
"BE",
"CH",
"AT",
"PT",
"SE",
"NO",
"DK",
"FI",
"PL",
"CZ",
"RO",
"HU",
"GR",
"TR",
"UA",
"RU",
"MX",
"BR",
"AR",
"CL",
"CO",
"PE",
"JP",
"KR",
"CN",
"TW",
"HK",
"ID",
"TH",
"VN",
"PH",
"MY",
"SG",
"SA",
"AE",
"IL",
"EG",
"ZA",
"NG",
"KE",
"MA"
],
"type": "string",
"description": "Country to measure interest in. Need a sub-region (e.g. a US state)? Paste a trends.google.com URL in the URLs field instead — its location is used as-is.",
"default": ""
},
"category": {
"title": "Category",
"enum": [
"0",
"3",
"47",
"44",
"22",
"12",
"5",
"7",
"71",
"8",
"45",
"65",
"11",
"13",
"958",
"19",
"16",
"299",
"14",
"66",
"29",
"533",
"174",
"18",
"20",
"67"
],
"type": "string",
"description": "Restrict results to one topic area (like the category picker on trends.google.com).",
"default": "0"
},
"property": {
"title": "Search property",
"enum": [
"",
"news",
"images",
"youtube",
"froogle"
],
"type": "string",
"description": "Which Google property to measure.",
"default": ""
},
"trendingNow": {
"title": "Scrape Trending Now",
"type": "boolean",
"description": "Also return what is trending right now (live trending searches with search volume, growth % and related queries) for the countries below.",
"default": false
},
"trendingNowGeos": {
"title": "Trending Now countries",
"type": "array",
"description": "Country codes for Trending Now (e.g. US, FR, DE).",
"default": [
"US"
],
"items": {
"type": "string"
}
},
"trendingNowHours": {
"title": "Trending Now window (hours)",
"minimum": 4,
"maximum": 168,
"type": "integer",
"description": "Look-back window: 4, 24, 48 or 168 hours.",
"default": 24
},
"maxTrends": {
"title": "Max trends per country",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Cap on Trending Now records per country.",
"default": 200
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}