{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper - Interest Over Time, Region & Queries", "description": "For SEO teams, market researchers and AI agents: Google Trends for up to 5 terms compared on one 0-100 scale - interest over time, by region, and top and rising related queries. One term took 3.8-6.7 s, 30 terms 54 s, no browser. Watch mode returns only new data points; unanswerable terms are free.", "version": "0.1", "x-build-id": "228Rh6whl7VWyfxLn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-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/neverempty~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-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/neverempty~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-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 to look up on Google Trends, one per line (up to 100 per run). Each term becomes one result row with interest over time, interest by region and related queries. Empty = coffee.", "items": { "type": "string" } }, "compareTerms": { "title": "Compare the terms with each other", "type": "boolean", "description": "On = the terms are compared together in groups of up to 5, exactly like typing them into one Google Trends comparison, so their values share the same 0-100 scale (100 = the highest point of any term in the group). Off (or empty) = each term is looked up on its own, 100 = its own peak." }, "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": "The Google Trends time range. Empty = Past 12 months. Ignored when Custom time range is set." }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Optional. A start and end date separated by a space, for example 2024-01-01 2024-12-31. Overrides Time range." }, "geo": { "title": "Country or region", "type": "string", "description": "Optional. A two-letter country code (US, GB, DE, JP) or a region code (US-CA, GB-ENG). Empty = worldwide. Interest by region is by country for worldwide, by state or province for a country, and by metro area for a US state." }, "category": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Optional. The Google Trends category number, the same number as cat= in a Google Trends URL. Empty or 0 = all categories." }, "searchType": { "title": "Search type", "enum": [ "web", "images", "news", "youtube", "shopping" ], "type": "string", "description": "Which Google search the popularity is measured on. Empty = Web Search." }, "includeInterestByRegion": { "title": "Include interest by region", "type": "boolean", "description": "On (or empty) = add the regions where the term is most popular (interestByRegion, topRegion). Off = skip it for a faster run." }, "includeRelatedQueries": { "title": "Include related queries", "type": "boolean", "description": "On (or empty) = add related queries: top (relatedQueriesTop) and rising (relatedQueriesRising, with the growth Google shows, such as +250% or Breakout). Off = skip them for a faster run." }, "onlyChanges": { "title": "Only return terms that changed since the last run", "type": "boolean", "description": "On = watch mode for scheduled runs. The first run returns every term (changeType first-check). Later runs return a term only when Google Trends has a new complete data point since the last run (a new week for Past 12 months, a new day for Past 30 days, a new hour for Past 7 days), with the new points in the changes column (changeType changed). Related queries not seen before are listed there too, but do not count as a change: Google samples related queries, so they shift between requests. Terms without a change come back as a free no-change row. Off (or empty) = always return every term." }, "watchName": { "title": "Watch name", "type": "string", "description": "Optional, used with Only return terms that changed. Runs with the same watch name share what has already been returned. Give different names to two schedules that watch the same terms for different purposes. Letters, digits, dot, dash and underscore." }, "resetMonitoringState": { "title": "Reset monitoring state", "type": "boolean", "description": "Forget what this watch remembered at the start of this run, so every term is a first check again. Turn it off again for scheduled runs." } } }, "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 } } } } } } } } } }