{ "openapi": "3.0.1", "info": { "title": "Google Trends API: Trending Now & Interest Over Time", "description": "Trending-now searches and new-trends alerts/monitoring per country with the news behind them, plus interest over time, interest by region, and related and rising queries for any keyword. For SEO, content and marketing teams. No API key, plain HTTP, MCP/API-ready; pay only for data delivered.", "version": "0.5", "x-build-id": "0aj7y8OnSUgfXnm9r" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/redomic~google-trends/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-redomic-google-trends", "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/redomic~google-trends/runs": { "post": { "operationId": "runs-sync-redomic-google-trends", "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/redomic~google-trends/run-sync": { "post": { "operationId": "run-sync-redomic-google-trends", "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 look up. Each term is fetched on its own unless you turn on comparison. Leave empty (and no trending countries) to get today's US trending searches.", "default": [], "items": { "type": "string" } }, "compareTerms": { "title": "Compare terms against each other", "type": "boolean", "description": "Group terms in fives into one comparison, so values are relative to each other (like the Compare box on the Trends site).", "default": false }, "geo": { "title": "Country or region", "type": "string", "description": "Two-letter country code (US, IN, GB) or region code (US-CA). Leave empty for worldwide. You can also pass comma-separated regions (e.g., US,GB,IN) to fetch for multiple regions in one run.", "default": "" }, "regionFilter": { "title": "Region filter (alias)", "type": "string", "description": "Alias for geo. Accepts a single region or comma-separated regions (e.g., US,GB,IN).", "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 to cover: now 1-H (past hour), now 4-H, now 1-d (past day), now 7-d, today 1-m (past month), today 3-m, today 12-m (default), today 5-y, all (2004 onwards). Use the custom field below for exact dates.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom date range", "type": "string", "description": "Optional. Format: YYYY-MM-DD YYYY-MM-DD. Overrides the time range above.", "default": "" }, "dataTypes": { "title": "Data to fetch", "type": "array", "description": "Only the sections you pick are fetched and charged.", "items": { "type": "string", "enum": [ "interestOverTime", "interestByRegion", "relatedQueries", "relatedTopics" ], "enumTitles": [ "Interest over time", "Interest by region", "Related queries", "Related topics" ] }, "default": [ "interestOverTime", "interestByRegion", "relatedQueries" ] }, "geoResolution": { "title": "Interest by region: geo resolution", "enum": [ "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Granularity for the interestByRegion section: COUNTRY, REGION (states/provinces, default), CITY, or DMA (US). Ignored when interestByRegion is not selected.", "default": "REGION" }, "includeLowSearchVolumeGeos": { "title": "Interest by region: include low-volume geos", "type": "boolean", "description": "Include regions/cities with low search volume in interestByRegion results. Default is false.", "default": false }, "searchProperty": { "title": "Search type", "enum": [ "", "images", "news", "youtube", "froogle" ], "type": "string", "description": "Which Google search the data comes from.", "default": "" }, "category": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Google Trends category number. 0 means all categories.", "default": 0 }, "trendingNowGeos": { "title": "Trending now: countries", "type": "array", "description": "Optional. Two-letter country codes to also fetch today's trending searches with related news.", "default": [], "items": { "type": "string" } }, "onlyNewTrending": { "title": "Trending now: only new searches", "type": "boolean", "description": "Return (and charge) only trending searches this country has not shown in earlier runs of the last 7 days. Schedule it hourly to get an alert feed of new trends. History is kept in a named key-value store in your account.", "default": false }, "includeShoppingProducts": { "title": "Shopping: include product results", "type": "boolean", "description": "Also fetch Google Shopping product results for each search term (title, numeric price, original price, merchant, rating, review count) via the Google SERP proxy and put them in the same row as the trend data. Off by default. No extra charge per product.", "default": false }, "shoppingMaxProducts": { "title": "Shopping: max products per term", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many Google Shopping products to include per search term when includeShoppingProducts is on.", "default": 10 }, "language": { "title": "Language", "type": "string", "description": "Language for topic names and labels, for example en-US or hi-IN.", "default": "en-US" }, "maxConcurrency": { "title": "Max parallel terms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Higher is faster but more likely to hit Google's rate limits.", "default": 3 }, "perTermTimeoutSecs": { "title": "Time budget per term (seconds)", "minimum": 15, "maximum": 600, "type": "integer", "description": "A term that is not done in this time gets a status row and the run moves on.", "default": 90 }, "maxRetries": { "title": "Attempts per request", "minimum": 1, "maximum": 12, "type": "integer", "description": "Each retry after a block uses a new IP and fresh cookies.", "default": 6 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxies work best for Google.", "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 } } } } } } } } } }