{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper: Compare Unlimited Terms", "description": "Google Trends data without a browser: interest over time, interest by region, related queries with Breakout growth and Trending now with news. Compare any number of terms on one 0-100 scale, not just five.", "version": "0.1", "x-build-id": "sT8c8yb4uiCHp3RXc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/famed_bonobo~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-famed_bonobo-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/famed_bonobo~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-famed_bonobo-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/famed_bonobo~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-famed_bonobo-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 get", "enum": [ "keywords", "trendingNow", "suggestions" ], "type": "string", "description": "Keywords gives the interest over time, the interest by region and the related queries of your search terms. Trending now lists what is trending on Google right now in a country, with search volume, growth, categories and news. Suggestions finds the Google topic (with its id) behind a text such as \"python\" the programming language or the snake.", "default": "keywords" }, "terms": { "title": "Search terms", "type": "array", "description": "Keywords mode and Suggestions mode. Up to 2,000 searches per run. A text such as \"python\" matches every search that contains it; a topic id such as \"/m/05z1_\" (find ids with Suggestions mode) is exact and counts searches in all languages.", "items": { "type": "string" } }, "geos": { "title": "Regions", "type": "array", "description": "Keywords mode. Country codes such as \"US\" or \"GB\", states such as \"US-CA\", or leave empty for worldwide. Each region is searched on its own, so 3 terms in 2 regions give 6 results.", "default": [], "items": { "type": "string" } }, "timeRange": { "title": "Period", "enum": [ "past1Hour", "past4Hours", "past1Day", "past7Days", "past30Days", "past90Days", "past12Months", "past5Years", "since2004" ], "type": "string", "description": "The period to chart. Up to 7 days Google gives minute-by-minute points, up to 90 days daily, up to 5 years weekly, and for all data monthly.", "default": "past12Months" }, "customTimeRange": { "title": "Custom period", "type": "string", "description": "Replaces the period above. Two dates like \"2024-01-01 2024-06-30\" (from 2004 to today), or, for hour-by-hour data in a window of up to 7 days, two hours like \"2026-10-10T08 2026-10-12T20\" (UTC)." }, "comparison": { "title": "How to compare terms", "enum": [ "separate", "together", "anchored" ], "type": "string", "description": "Separate: each term is charted on its own, its highest point is 100. Together: up to 5 terms share one scale, so you see which is bigger. Anchored: any number of terms share one scale, by comparing them in groups through one anchor term.", "default": "separate" }, "anchorTerm": { "title": "Anchor term", "type": "string", "description": "Anchored comparison only. A term with steady, high interest; every group of terms is compared through it. The first search term when empty." }, "searchType": { "title": "Where people searched", "enum": [ "web", "images", "news", "youtube", "shopping" ], "type": "string", "description": "Google Web Search, or one of its other searches.", "default": "web" }, "category": { "title": "Category", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Google Trends category id that narrows what the term means, such as 31 for Programming. 0 means all categories.", "default": 0 }, "includeRegions": { "title": "Interest by region", "type": "boolean", "description": "Add, for each term, the regions where it is searched most (states of a country, countries worldwide).", "default": true }, "regionResolution": { "title": "Region level", "enum": [ "auto", "country", "region", "city", "dma" ], "type": "string", "description": "Auto lets Google choose: countries for a worldwide search, states for a country. Other levels work where Google offers them, for example cities or ad markets (DMA) in a country.", "default": "auto" }, "includeLowSearchVolumeRegions": { "title": "Include regions with few searches", "type": "boolean", "description": "Also list regions where the term is searched very little.", "default": false }, "includeRelatedQueries": { "title": "Related queries", "type": "boolean", "description": "Add, for each term, the top searches and the rising searches (with their growth, or \"Breakout\" above 5,000 %) that people made along with it.", "default": true }, "outputFormat": { "title": "Result layout", "enum": [ "perKeyword", "timelineRows" ], "type": "string", "description": "One result per term and region with its timeline inside, or one row per point of the timeline (easier for spreadsheets and charts; the price is the same).", "default": "perKeyword" }, "language": { "title": "Language", "type": "string", "description": "Language of Google's names and texts, such as \"en-US\", \"es\" or \"de\". It does not change which searches are counted.", "default": "en-US" }, "trendingGeos": { "title": "Countries to list", "type": "array", "description": "Trending now mode. Country codes such as \"US\", \"GB\" or \"CR\", or states such as \"US-CA\".", "items": { "type": "string" } }, "trendingHours": { "title": "Trending in the last (hours)", "minimum": 1, "maximum": 191, "type": "integer", "description": "How far back Google looks for searches that grew, from 1 to 191 hours. Its page offers 4, 24, 48 and 168 (7 days).", "default": 24 }, "maxTrendsPerGeo": { "title": "Most trends per country", "minimum": 0, "maximum": 1000, "type": "integer", "description": "The first trends of Google's list, which is ordered by search volume. 0 means all (often 200 to 500).", "default": 0 }, "newsPerTrend": { "title": "News articles per trend", "minimum": 0, "maximum": 5, "type": "integer", "description": "News articles Google shows with each trend (title, source, link, time, image). 0 for none.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leave Apify Proxy off for most runs: the Actor then reaches Google Trends from the platform's own address, which Google answers. For very large runs, residential proxies add addresses to spread the requests over. Google Trends currently turns away datacenter proxies.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }