{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Extract Google Trends data without an API key: search interest over time, interest by region, top and rising related queries, and today's trending searches by country. Every row carries keyword, date, value and geo. Export JSON, CSV or Excel.", "version": "2.0", "x-build-id": "EaAZlwm7Mzpy71FcC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/herus13~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-herus13-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/herus13~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-herus13-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/herus13~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-herus13-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": { "data_type": { "title": "What to scrape", "enum": [ "interest_over_time", "interest_by_region", "related_queries", "trending_now" ], "type": "string", "description": "What the run returns; pick one, so every row in the dataset has the same shape. interest_over_time gives the 0 to 100 search-interest index per date for each keyword. interest_by_region gives that index per country or region. related_queries gives the top and rising searches people also run. trending_now gives today's trending searches for one country and needs no keyword. Default interest_over_time.", "default": "interest_over_time" }, "keywords": { "title": "Keywords", "type": "array", "description": "1 to 5 search terms; several terms are compared against each other, which is Google Trends' own limit. Needed for interest_over_time, interest_by_region and related_queries. Leave empty for trending_now, which reads a whole country rather than a term.", "items": { "type": "string" } }, "geo": { "title": "Geo (country code)", "type": "string", "description": "Two-letter country code to scope the numbers to, for example US, GB or VN. Leave empty for worldwide figures. Must be set when data_type is trending_now, which is always about one country." }, "timeframe": { "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": "How far back search interest is measured. Default `today 12-m`. Choose `now 1-H`, `now 4-H`, `now 1-d` or `now 7-d` for the past hour, four hours, day or week; `today 1-m`, `today 3-m`, `today 12-m` or `today 5-y` for the past 30 days, 90 days, 12 months or five years; or `all` for 2004 to today. Used by interest_over_time, interest_by_region and related_queries, and ignored by trending_now.", "default": "today 12-m" }, "category": { "title": "Category", "enum": [ "0", "3", "47", "44", "22", "12", "5", "7", "71", "8", "45", "65", "11", "13", "958", "19", "16", "299", "14", "66", "29", "533", "174", "18", "20", "67" ], "type": "string", "description": "Restrict the numbers to one Google Trends category, which settles ambiguous terms: apple under Finance is the stock, under Food is the fruit. Default 0, every category. Codes: 3 Arts, 47 Autos, 44 Beauty, 22 Books, 12 Business, 5 Computers, 7 Finance, 71 Food, 8 Games, 45 Health, 65 Hobbies, 11 Home, 13 Internet, 958 Jobs, 19 Law, 16 News, 299 Online Communities, 14 People, 66 Pets, 29 Real Estate, 533 Reference, 174 Science, 18 Shopping, 20 Sports, 67 Travel.", "default": "0" }, "hl": { "title": "Language (hl)", "type": "string", "description": "Language the region names and trending titles come back in, as a language tag such as en-US, de-DE or vi-VN. Default en-US.", "default": "en-US" }, "tz": { "title": "Timezone offset (minutes)", "type": "integer", "description": "Timezone offset in minutes that dates are reported against, for example -420 for US Pacific daylight time or 0 for UTC. Default -420.", "default": -420 }, "max_records": { "title": "Max records", "minimum": 1, "type": "integer", "description": "Ceiling on the number of rows a single run writes, at least 1. Leave empty for no ceiling. Worth setting for interest_by_region and trending_now, where one request can return hundreds of rows." }, "proxyUrls": { "title": "Your own proxy URLs (optional)", "type": "array", "description": "Leave empty and the run uses a residential proxy that is included in the price of the run. To route through your own account instead, add one gateway URL per entry, for example http://user:pass@host:port. Works with DataImpulse, Bright Data, Oxylabs, Smartproxy or any provider that issues URLs. When you set this, only these URLs are used.", "items": { "type": "string" } } } }, "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 } } }, "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 } } } } } } } } } }