{ "openapi": "3.0.1", "info": { "title": "Naver DataLab Search Trends", "description": "Compare Naver search trends for up to five keyword groups. Get daily, weekly, or monthly interest ratios with device, gender, and age filters. Export each group series as JSON, CSV, or Excel for research and reports.", "version": "0.0", "x-build-id": "LQmDJD0275Bvtd6IN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~naver-search-trends/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-naver-search-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/maximedupre~naver-search-trends/runs": { "post": { "operationId": "runs-sync-maximedupre-naver-search-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/maximedupre~naver-search-trends/run-sync": { "post": { "operationId": "run-sync-maximedupre-naver-search-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": [ "keywordGroups", "startDate", "endDate" ], "properties": { "keywordGroups": { "title": "Keyword groups", "minItems": 1, "maxItems": 5, "type": "array", "description": "Add one to five groups to compare together. Each group combines one to 20 Korean or English terms. Put each full phrase in its own terms entry.", "items": { "type": "object", "required": [ "name", "terms" ], "properties": { "name": { "title": "Group name", "description": "Name this group in the trend results. The name must not contain __SZLIG__ or __OUML__.", "type": "string", "editor": "textfield", "minLength": 1, "pattern": "^(?![\\s\\S]*(?:__SZLIG__|__OUML__))[\\s\\S]+$" }, "terms": { "title": "Terms", "description": "Add one to 20 related terms or spelling variants. Their search interest is combined for this group. Each entry must not contain a comma or __OUML__. Put separate terms in separate entries.", "type": "array", "editor": "stringList", "minItems": 1, "maxItems": 20, "items": { "type": "string", "minLength": 1, "pattern": "^(?![\\s\\S]*(?:,|__OUML__))[\\s\\S]+$" } } } } }, "startDate": { "title": "Start date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "First date to include, in YYYY-MM-DD form. For Daily, choose any available day. For Weekly or Monthly, choose the first day of a calendar month; partial months are not supported. Choose January 1, 2016 or later. Check available periods at https://datalab.naver.com/." }, "endDate": { "title": "End date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Last date to include, in YYYY-MM-DD form. For Daily, choose any available day, including the start date for a single-day range. For Weekly or Monthly, choose the last day of a calendar month; partial months are not supported. Choose a date on or after the start date. Check available periods at https://datalab.naver.com/." }, "maxItems": { "title": "Maximum rows", "minimum": 0, "type": "integer", "description": "Stop after this many output rows. Leave blank or use 0 for all available rows." }, "timeUnit": { "title": "Period interval", "enum": [ "date", "week", "month" ], "type": "string", "description": "Show search interest for each day, week, or month. Weekly and Monthly require a range of whole calendar months, from the first day of the start month through the last day of the end month.", "default": "date" }, "device": { "title": "Devices", "enum": [ "all", "mo", "pc" ], "type": "string", "description": "Choose which devices to include in the search trends.", "default": "all" }, "gender": { "title": "Gender", "enum": [ "all", "f", "m" ], "type": "string", "description": "Choose which audience to include in the search trends.", "default": "all" }, "ages": { "title": "Age bands", "type": "array", "description": "Choose one or more Naver age bands. Leave empty or omit this field for all ages.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11" ], "enumTitles": [ "0-12", "13-18", "19-24", "25-29", "30-34", "35-39", "40-44", "45-49", "50-54", "55-59", "60+" ] }, "default": [] } } }, "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 } } } } } } } } } }