{ "openapi": "3.0.1", "info": { "title": "Naver DataLab Search Trend (English)", "description": "Official Naver Search Trend API wrapper. Type English or Korean keywords and get a relative search-index time series. Not a scraper. Shopping search API is gone — this is Search Trend only.", "version": "0.1", "x-build-id": "20nV8Z8PHBWlc9FIR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hantaeyoung~naver-datalab-trend/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hantaeyoung-naver-datalab-trend", "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/hantaeyoung~naver-datalab-trend/runs": { "post": { "operationId": "runs-sync-hantaeyoung-naver-datalab-trend", "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/hantaeyoung~naver-datalab-trend/run-sync": { "post": { "operationId": "run-sync-hantaeyoung-naver-datalab-trend", "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": [ "keywords", "startDate", "endDate" ], "properties": { "keywords": { "title": "Keywords", "minItems": 1, "maxItems": 50, "type": "array", "description": "Search terms in English or Korean. For Korean-market volume, type Hangul (e.g. 달팽이크림). English is sent as-is unless Translate English is on AND optional NCP Papago keys are set.", "items": { "type": "string" } }, "startDate": { "title": "Start date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Range start (YYYY-MM-DD). Official data starts 1 January 2016." }, "endDate": { "title": "End date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Range end (YYYY-MM-DD). Must be on or after the start date." }, "timeUnit": { "title": "Time unit", "enum": [ "date", "week", "month" ], "type": "string", "description": "Official interval: date (daily), week (weekly), month (monthly).", "default": "week" }, "device": { "title": "Device", "enum": [ "all", "pc", "mo" ], "type": "string", "description": "Official device filter. 'All' omits the field (every environment). pc = desktop, mo = mobile.", "default": "all" }, "gender": { "title": "Gender", "enum": [ "all", "m", "f" ], "type": "string", "description": "Official gender filter. 'All' omits the field. m = male, f = female.", "default": "all" }, "ages": { "title": "Age groups", "type": "array", "description": "Official age codes only. Leave empty for all ages. 1=0–12, 2=13–18, 3=19–24, 4=25–29, 5=30–34, 6=35–39, 7=40–44, 8=45–49, 9=50–54, 10=55–59, 11=60+.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11" ], "enumTitles": [ "0–12 (1)", "13–18 (2)", "19–24 (3)", "25–29 (4)", "30–34 (5)", "35–39 (6)", "40–44 (7)", "45–49 (8)", "50–54 (9)", "55–59 (10)", "60+ (11)" ] } }, "translateEnglish": { "title": "Optional: translate English via NCP Papago", "type": "boolean", "description": "Off by default: Latin-script keywords are sent to Search Trend unchanged. Turn on only if you also set PAPAGO_CLIENT_ID / PAPAGO_CLIENT_SECRET from NCP Papago Translation (a different product). developers.naver.com Papago is dead and is never called. Hangul keywords are never translated. Papago failure keeps the original term and does not abort the run.", "default": false }, "maxKeywords": { "title": "Max keywords", "minimum": 1, "maximum": 50, "type": "integer", "description": "Hard cap (Actor-level, not a Naver field). Extra keywords are dropped. Official API allows 5 keyword groups per request; this Actor batches automatically.", "default": 50 } } }, "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 } } } } } } } } } }