{ "openapi": "3.0.1", "info": { "title": "Google Trends API — Interest, Regions & Queries", "description": "Google Trends data for a list of search terms: interest over time, interest by country or region, and related queries (top and rising). One flat row per term and country, every field always present, never null. Only complete rows are billed.", "version": "0.1", "x-build-id": "UQASIinEM6FQ79wAL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sumitr_mardy~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sumitr_mardy-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/sumitr_mardy~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-sumitr_mardy-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/sumitr_mardy~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-sumitr_mardy-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", "required": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "minItems": 1, "maxItems": 2000, "type": "array", "description": "Search terms to look up, one per item, up to 100 characters each. Each term is looked up on its own (not compared against the others), so each row's values are on that term's own 0–100 scale. Example: [\"coffee\", \"matcha\"].", "items": { "type": "string" } }, "geos": { "title": "Countries / regions", "type": "array", "description": "Where to measure interest: 2-letter country codes (\"US\", \"DE\", \"VN\"), regions (\"US-CA\"), or leave empty for worldwide. Every search term is fetched once per entry, and each pair is one row. Example: [\"US\", \"GB\"].", "items": { "type": "string" } }, "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 covered by every section. Google picks the resolution: minutes for the past hour, days up to 90 days, weeks for 12 months, months beyond.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "pattern": "^(\\d{4}-\\d{2}-\\d{2} \\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Overrides Time range. Format \"YYYY-MM-DD YYYY-MM-DD\", e.g. \"2025-01-01 2025-06-30\". Leave empty to use Time range." }, "category": { "title": "Category ID", "minimum": 0, "type": "integer", "description": "Google Trends category ID to narrow the search, e.g. 71 = Food & Drink, 5 = Computers & Electronics. 0 = all categories.", "default": 0 }, "property": { "title": "Google property", "enum": [ "", "images", "news", "froogle", "youtube" ], "type": "string", "description": "Which Google search to measure. Default is web search.", "default": "" }, "interestOverTime": { "title": "Interest over time", "type": "boolean", "description": "Include interestOverTime: the 0–100 interest series for the time range, plus averageInterest, peakInterest, peakDate and latestInterest.", "default": true }, "interestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Include interestByRegion: 0–100 interest per country (worldwide), or per state/region (when a country is given).", "default": true }, "relatedQueries": { "title": "Related queries", "type": "boolean", "description": "Include relatedQueriesTop and relatedQueriesRising: what people also searched for. Rising values are percent growth; \"Breakout\" means more than +5000%.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Interface language for region names, e.g. \"en-US\", \"de\", \"ja\". Does not change which searches are counted.", "default": "en-US" } } }, "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 } } } } } } } } } }