{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper",
"description": "Interest over time, interest by region, related queries and topics for any search term, country, time range, category and Google property, straight from Google Trends' data API. No browser, no login; every term gets a row that says why when Google has nothing.",
"version": "1.0",
"x-build-id": "LkIT2FnVSzEnAqlWh"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/steadyscrape~google-trends-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-steadyscrape-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/steadyscrape~google-trends-scraper/runs": {
"post": {
"operationId": "runs-sync-steadyscrape-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/steadyscrape~google-trends-scraper/run-sync": {
"post": {
"operationId": "run-sync-steadyscrape-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": "One term per line. Each term is queried on its own unless Compare terms is on. A Knowledge Graph topic id (/m/05p0rrx) works too.",
"items": {
"type": "string"
}
},
"urls": {
"title": "Google Trends links",
"type": "array",
"description": "Explore links copied from Google Trends (trends.google.com/trends/explore?q=…&geo=…&date=…). Each link carries its own terms, geo, time range, category and property; comma-separated terms in q are compared.",
"items": {
"type": "string"
}
},
"compareTerms": {
"title": "Compare terms",
"type": "boolean",
"description": "Put the search terms in one chart (five per chart), so every value is relative to the most searched of the group, as on the Google Trends page. Off: each term is scored on its own 0–100 scale.",
"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": "Google's presets. now ranges are hourly, today ranges daily or weekly. Dates below override it.",
"default": "today 12-m"
},
"dateFrom": {
"title": "Custom range: from",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string",
"description": "YYYY-MM-DD. With to, replaces the time range."
},
"dateTo": {
"title": "Custom range: to",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string",
"description": "YYYY-MM-DD, not before from."
},
"geo": {
"title": "Location",
"pattern": "^([A-Za-z]{2}(-[A-Za-z0-9]{1,3})?)?$",
"type": "string",
"description": "A country code (US, BR) or a region code (US-CA, GB-ENG). Empty: worldwide."
},
"category": {
"title": "Category",
"minimum": 0,
"type": "integer",
"description": "Google Trends category id (0 all, 7 Finance, 12 Business, 5 Computers, 45 Health…). The id is the cat parameter of an explore link.",
"default": 0
},
"property": {
"title": "Google property",
"enum": [
"",
"images",
"news",
"youtube",
"froogle"
],
"type": "string",
"description": "Which searches to count.",
"default": ""
},
"sections": {
"title": "Data to fetch",
"uniqueItems": true,
"type": "array",
"description": "Fewer sections means fewer requests per term.",
"items": {
"type": "string",
"enum": [
"interestOverTime",
"interestByRegion",
"relatedQueries",
"relatedTopics"
],
"enumTitles": [
"Interest over time",
"Interest by region",
"Related queries (top and rising)",
"Related topics (top and rising)"
]
},
"default": [
"interestOverTime",
"interestByRegion",
"relatedQueries",
"relatedTopics"
]
},
"regionLevel": {
"title": "Region level",
"enum": [
"auto",
"country",
"region",
"city",
"dma"
],
"type": "string",
"description": "How fine the interest-by-region breakdown is. Auto: what Google shows by default (countries for worldwide, regions for a country). DMA is US metro areas.",
"default": "auto"
},
"language": {
"title": "Language of names",
"pattern": "^[a-z]{2}(-[A-Za-z]{2})?$",
"type": "string",
"description": "Language for region names and topic titles (en, es, pt-BR).",
"default": "en"
},
"residentialFallback": {
"title": "Fall back to residential proxies",
"type": "boolean",
"description": "When Google refuses the run's own IP and the datacenter proxies, retry through residential proxies (included in the price: you pay per row, not per proxy byte). Off: those terms come back with status blocked, unpaid.",
"default": 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
}
}
}
}
}
}
}
}
}
}