{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper",
"description": "Reliable Google Trends API: interest over time, interest by region, related queries and topics for up to 5 compared terms, plus Trending now searches by country. Retries blocked requests, monitor mode.",
"version": "0.1",
"x-build-id": "EFfBat416w5RDEDyC"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/wakeful_outhouse~google-trends-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-wakeful_outhouse-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/wakeful_outhouse~google-trends-scraper/runs": {
"post": {
"operationId": "runs-sync-wakeful_outhouse-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/wakeful_outhouse~google-trends-scraper/run-sync": {
"post": {
"operationId": "run-sync-wakeful_outhouse-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 per line. Compare up to 5 terms on one line, separated by commas (coffee, tea). You can also paste a Google Trends Explore URL (its location, time range, category and search type are used).",
"items": {
"type": "string"
}
},
"modes": {
"title": "Data to collect",
"uniqueItems": true,
"type": "array",
"description": "Each selected data type gives one result per input line (related queries and topics: one per term). Google often hides related topics from automated clients; empty lists are skipped and not charged.",
"items": {
"type": "string",
"enum": [
"interestOverTime",
"interestByRegion",
"relatedQueries",
"relatedTopics"
],
"enumTitles": [
"Interest over time",
"Interest by region",
"Related queries",
"Related topics (often withheld by Google)"
]
},
"default": [
"interestOverTime"
]
},
"geo": {
"title": "Location",
"type": "string",
"description": "Country (US), region (US-CA) or metro code (US-NY-501). Empty means 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 of the chart.",
"default": "today 12-m"
},
"customTimeRange": {
"title": "Custom time range",
"type": "string",
"description": "Overrides the time range: 2024-01-01 2024-12-31 for days, or 2026-10-01T00 2026-10-07T23 for hours (up to 7 days)."
},
"category": {
"title": "Category ID",
"minimum": 0,
"type": "integer",
"description": "Google Trends category, e.g. 71 Food & Drink, 18 Shopping, 7 Finance. 0 means all categories. The ID is the cat= value in a Google Trends URL.",
"default": 0
},
"searchType": {
"title": "Search type",
"enum": [
"web",
"images",
"news",
"youtube",
"shopping"
],
"type": "string",
"description": "Which Google search the data comes from.",
"default": "web"
},
"includeLowVolumeRegions": {
"title": "Include regions with low search volume",
"type": "boolean",
"description": "Interest by region: also return regions with too little data (value 0).",
"default": false
},
"trendingCountries": {
"title": "Trending now: countries",
"type": "array",
"description": "Two-letter country codes (US, GB, DE…). Returns the searches trending right now, as on trends.google.com/trending: search volume, growth, start time, related searches and news. One result per trend.",
"items": {
"type": "string"
}
},
"trendingHours": {
"title": "Trending now: period",
"enum": [
"4",
"24",
"48",
"168"
],
"type": "string",
"description": "Trends that started within this period.",
"default": "24"
},
"trendingCategories": {
"title": "Trending now: categories",
"type": "array",
"description": "Only trends in these categories. Empty means all.",
"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"
]
},
"default": []
},
"trendingActiveOnly": {
"title": "Trending now: active trends only",
"type": "boolean",
"description": "Skip trends that have already ended.",
"default": false
},
"maxTrendsPerCountry": {
"title": "Trending now: max trends per country",
"minimum": 0,
"type": "integer",
"description": "Stop after this many trends for each country. 0 means no limit (the US often has 500+ trends a day).",
"default": 100
},
"includeNews": {
"title": "Trending now: add news articles",
"type": "boolean",
"description": "Add news headlines and pictures to the newest trends (from the Google Trends RSS feed, which covers about the 10 newest trends). Free.",
"default": true
},
"monitorName": {
"title": "Monitor name (only changes)",
"type": "string",
"description": "Turn on monitoring: give this run any name, for example weekly-brands. Each run with the same name then saves only new trending searches, and only those Explore results that changed since the previous run (new timeline points, new related queries, changed regions). New items are marked with isNew. You pay only for saved results. Use it with an Apify Schedule. The first run saves everything. The state is kept in the google-trends-monitor key-value store of your account. Leave empty for a normal run."
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many search terms run in parallel.",
"default": 5
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Residential proxy is recommended: Google limits requests per IP.",
"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
}
}
}
}
}
}
}
}
}
}