{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper", "description": "Scrape trending Google searches by country with search volume, growth, category and the related queries people search alongside each trend.", "version": "0.1", "x-build-id": "OSRr0vkPfFRlR0IrB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/juanoox~google-trends/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-juanoox-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/juanoox~google-trends/runs": { "post": { "operationId": "runs-sync-juanoox-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/juanoox~google-trends/run-sync": { "post": { "operationId": "run-sync-juanoox-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", "required": [ "geos" ], "properties": { "geos": { "title": "Countries", "type": "array", "description": "Two-letter country codes, one per country you want. US, AR, ES, GB, IN, BR. Each country is a single request that returns its whole trending list.", "default": [ "US" ], "items": { "type": "string" } }, "window": { "title": "Time window", "enum": [ "4h", "24h", "48h", "7d" ], "type": "string", "description": "How far back to look. A wider window returns far more terms: the same country goes from about 100 trends over 4 hours to roughly 1,700 over 7 days.", "default": "24h" }, "categories": { "title": "Categories", "type": "array", "description": "Keep only trends in these categories, by name: Sports, Politics, Entertainment, Business and Finance, Technology, Health, Games, Travel and Transportation, Climate, and others. A name Google does not publish stops the run with the valid list, rather than silently returning nothing.", "items": { "type": "string" } }, "minVolume": { "title": "Minimum search volume", "minimum": 0, "type": "integer", "description": "Keep only trends with at least this many estimated searches. 20000 drops the long tail and leaves what actually moved. Trends with no volume are dropped, because they cannot be said to clear a minimum." }, "onlyWithRelatedQueries": { "title": "Only trends with related queries", "type": "boolean", "description": "Google publishes the surrounding queries for roughly one trend in five. Turn this on when you want the ones you can actually build keyword research from.", "default": false }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep only trends whose term or related queries contain one of these. This is how you watch a brand or a topic across countries.", "items": { "type": "string" } }, "maxItems": { "title": "Max results", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Hard cap on how many trends are saved and charged. 0 means no cap.", "default": 500 }, "includeSeen": { "title": "Include trends already seen in previous runs", "type": "boolean", "description": "Off means the run only saves trends it has never returned before, which is what you want when running this on a schedule.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel requests, one per country.", "default": 2 }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times a failed request is retried before that country is given up on.", "default": 3 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "Rate limit for the whole run.", "default": 30 } } }, "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 } } } } } } } } } }