{ "openapi": "3.0.1", "info": { "title": "Naver Keyword Search Volume (네이버 키워드 검색량)", "description": "Get monthly Naver search volumes (PC and mobile), ad competition, CTR and hundreds of related keyword ideas for any Korean keyword, straight from the Naver SearchAd keyword tool. Korea's top search engine, in English JSON.", "version": "0.1", "x-build-id": "YHeUN0jXrFkaNiAEW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/andong-keyword-lab~naver-keyword-volume/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-andong-keyword-lab-naver-keyword-volume", "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/andong-keyword-lab~naver-keyword-volume/runs": { "post": { "operationId": "runs-sync-andong-keyword-lab-naver-keyword-volume", "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/andong-keyword-lab~naver-keyword-volume/run-sync": { "post": { "operationId": "run-sync-andong-keyword-lab-naver-keyword-volume", "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" ], "properties": { "keywords": { "title": "Keywords", "minItems": 1, "maxItems": 1000, "type": "array", "description": "Keywords to look up on Naver, usually in Korean (e.g. 선크림, 캠핑의자). Spaces are ignored, because Naver treats '캠핑 의자' and '캠핑의자' as the same keyword. English brand names work too.", "items": { "type": "string" } }, "includeRelated": { "title": "Include related keywords", "type": "boolean", "description": "Also return the related keyword ideas Naver suggests for each keyword, with their own search volumes. Turn off to get only the volumes of your keywords (faster and cheaper).", "default": true }, "maxRelatedPerKeyword": { "title": "Max related keywords per keyword", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Upper limit of related keywords returned for each input keyword. Naver usually suggests several hundred. Each returned keyword is one billed result.", "default": 50 }, "sortRelatedBy": { "title": "Order related keywords by", "enum": [ "relevance", "volume" ], "type": "string", "description": "Relevance keeps Naver's own order, which puts the closest matches first. Volume puts the most searched keywords first. The limit above is applied after sorting.", "default": "relevance" }, "relatedMustContainSeed": { "title": "Only long-tail variants", "type": "boolean", "description": "Keep only related keywords that contain your keyword, e.g. 캠핑의자추천 or 경량캠핑의자 for 캠핑의자. Useful for SEO long-tail research.", "default": false }, "includeBidEstimates": { "title": "Include CPC bid estimates", "type": "boolean", "description": "Add Naver's estimated cost-per-click bids for each keyword: the bid needed for ad position 1 and 3, and the median bid, on PC and mobile, in KRW (median also in USD). Billed at a higher per-keyword price.", "default": false }, "minMonthlySearches": { "title": "Minimum monthly searches", "minimum": 0, "type": "integer", "description": "Skip related keywords with fewer total monthly searches (PC + mobile) than this. Your own keywords are always returned.", "default": 0 }, "naverCustomerId": { "title": "Naver SearchAd Customer ID (optional)", "type": "string", "description": "Your Naver SearchAd customer ID (numbers only)." }, "naverApiKey": { "title": "Naver SearchAd API key (access license)", "type": "string", "description": "The access license from the Naver SearchAd API Manager." }, "naverSecretKey": { "title": "Naver SearchAd secret key", "type": "string", "description": "The secret key from the Naver SearchAd API Manager." } } }, "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 } } } } } } } } } }