{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper - Interest, Regions & Related Queries",
"description": "Reliable Google Trends API alternative: interest over time, interest by region, related queries and topics for any keyword, country and time range, plus what is trending now. Automatic retries on Google rate limits.",
"version": "0.1",
"x-build-id": "DcW2frCdZ14saTRlN"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/dataspace~google-trends-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-dataspace-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/dataspace~google-trends-scraper/runs": {
"post": {
"operationId": "runs-sync-dataspace-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/dataspace~google-trends-scraper/run-sync": {
"post": {
"operationId": "run-sync-dataspace-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 or phrases to analyze on Google Trends, e.g. bitcoin, electric cars. Each term is one result.",
"items": {
"type": "string"
}
},
"compareKeywords": {
"title": "Compare terms on one chart",
"type": "boolean",
"description": "Off: every term is analyzed separately on its own 0-100 scale. On: terms are compared in groups of up to 5 (like typing them together into Google Trends), so values are relative to each other.",
"default": false
},
"geo": {
"title": "Country or region",
"type": "string",
"description": "Leave empty for worldwide. Use a 2-letter country code (US, GB, DE, TR) or a region code (US-CA, GB-ENG).",
"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",
"custom"
],
"type": "string",
"description": "Period to analyze. Pick 'Custom' to set exact dates below.",
"default": "today 12-m"
},
"customTimeRange": {
"title": "Custom time range",
"type": "string",
"description": "Only used when Time range is 'Custom'. Format: 2024-01-01 2024-12-31."
},
"searchProperty": {
"title": "Search type",
"enum": [
"",
"images",
"news",
"froogle",
"youtube"
],
"type": "string",
"description": "Which Google search to analyze.",
"default": ""
},
"includeInterestOverTime": {
"title": "Interest over time",
"type": "boolean",
"description": "Time series of search interest (0-100) with average, peak and latest value.",
"default": true
},
"includeInterestByRegion": {
"title": "Interest by region",
"type": "boolean",
"description": "Where the term is most popular: countries, or regions/cities inside the selected country.",
"default": true
},
"regionResolution": {
"title": "Region level",
"enum": [
"auto",
"COUNTRY",
"REGION",
"CITY",
"DMA"
],
"type": "string",
"description": "Level of detail for interest by region. 'Auto' = countries for worldwide, regions for a country.",
"default": "auto"
},
"includeRelatedQueries": {
"title": "Related queries",
"type": "boolean",
"description": "Top and rising searches related to the term (rising ones show % growth or 'Breakout').",
"default": true
},
"trendingNowCountries": {
"title": "Trending now countries",
"type": "array",
"description": "Optional. 2-letter country codes (e.g. US, GB, TR) to also get the Trending now list of Google Trends for those countries — the same list as on trends.google.com/trending: search volume, % increase, start time, category, related searches and news. Each trend is one result.",
"items": {
"type": "string"
}
},
"trendingNowHours": {
"title": "Trending now: time window",
"enum": [
"4",
"24",
"48",
"168"
],
"type": "string",
"description": "Trends that started in the last 4 hours, 24 hours, 48 hours or 7 days.",
"default": "24"
},
"trendingNowSortBy": {
"title": "Trending now: sort by",
"enum": [
"relevance",
"searchVolume",
"newest"
],
"type": "string",
"description": "Order of the trends; the max-trends limit is applied after sorting.",
"default": "relevance"
},
"maxTrendsPerCountry": {
"title": "Trending now: max trends per country",
"minimum": 0,
"type": "integer",
"description": "How many trends per country (after filters and sorting). 0 = all — often 200–600 per country.",
"default": 50
},
"trendingNowCategories": {
"title": "Trending now: categories",
"type": "array",
"description": "Keep only trends in these categories. Empty = 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"
]
}
},
"trendingNowMinVolume": {
"title": "Trending now: minimum search volume",
"minimum": 0,
"type": "integer",
"description": "Skip smaller trends, e.g. 10000 keeps only 10K+ searches."
},
"trendingNowActiveOnly": {
"title": "Trending now: only active trends",
"type": "boolean",
"description": "Skip trends that Google marks as no longer trending.",
"default": false
},
"includeTrendNews": {
"title": "Trending now: include news articles",
"type": "boolean",
"description": "Up to 3 news articles for each trend (title, URL, source, time, image).",
"default": true
},
"category": {
"title": "Category ID",
"minimum": 0,
"type": "integer",
"description": "Google Trends category ID to narrow results (0 = all categories). Example: 7 = Finance, 71 = Food & Drink.",
"default": 0
},
"language": {
"title": "Language",
"type": "string",
"description": "Language of related queries (e.g. en-US, de, fr, tr).",
"default": "en-US"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies are used automatically when Google rate-limits a request. If you run many terms and see repeated blocks, select the RESIDENTIAL proxy group.",
"default": {
"useApifyProxy": 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
}
}
}
}
}
}
}
}
}
}