{ "openapi": "3.0.1", "info": { "title": "Naver Open Search API — Web Blog News Cafe Image", "description": "Query Naver Search through the NAVER API HUB for web, blog, news, cafe, image, Knowledge iN, encyclopedia and local results with your own Client ID and Secret. Returns structured JSON with no cookies.", "version": "0.1", "x-build-id": "QAIgpoOCAZscL7pK6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~search-naver-open-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-search-naver-open-api", "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/khadinakbar~search-naver-open-api/runs": { "post": { "operationId": "runs-sync-khadinakbar-search-naver-open-api", "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/khadinakbar~search-naver-open-api/run-sync": { "post": { "operationId": "run-sync-khadinakbar-search-naver-open-api", "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": { "query": { "title": "Search query", "maxLength": 200, "type": "string", "description": "Single Naver search keyword, usually Korean (e.g. '강남 맛집' or '아이폰 15'). Provide this, queries, or both. Merged and de-duplicated with queries[]. Not a Naver Shopping product URL — for shopping use naver-product-shopping-scraper." }, "queries": { "title": "Search queries", "maxItems": 50, "type": "array", "description": "Batch of search keywords to run in one Actor run (up to 50 unique). Merged with query. Use for brand monitoring or multi-term SEO checks. Each item is a plain keyword string, not a URL.", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "searchType": { "title": "Search vertical", "enum": [ "blog", "news", "web", "cafe", "image", "kin", "encyc", "local", "adult", "errata" ], "type": "string", "description": "Which Naver Search API vertical to call. blog/news/web/cafe/image/kin/encyc/local return ranked lists. adult and errata return one helper row per query. shop, book, and doc are discontinued and rejected.", "default": "blog" }, "maxResults": { "title": "Maximum results (run)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on dataset rows for the whole run across all queries. Default 30, maximum 1000. Local search is capped at 5 results per query by Naver.", "default": 30 }, "maxResultsPerQuery": { "title": "Maximum results per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Per-query pagination budget before moving to the next keyword. Defaults to maxResults. Naver allows display up to 100 and start up to 1000 (local: display max 5, start 1).", "default": 30 }, "sort": { "title": "Sort order", "enum": [ "sim", "date", "random", "comment" ], "type": "string", "description": "Optional sort. For most list verticals use sim (relevance) or date. For local use random or comment. Ignored for adult/errata/encyc.", "default": "sim" }, "authStyle": { "title": "Auth style", "enum": [ "hub", "legacy" ], "type": "string", "description": "hub uses NAVER API HUB headers (X-NCP-APIGW-*). legacy uses older Developers Center headers (X-Naver-*) until 2027-06-30 fade-out. New applications should use hub.", "default": "hub" }, "stripHtmlTags": { "title": "Strip HTML highlight tags", "type": "boolean", "description": "When true (default), remove Naver highlight tags from title and description while keeping titleHtml/descriptionHtml originals.", "default": true }, "naverClientId": { "title": "Naver Client ID", "type": "string", "description": "Bring your own NAVER API HUB Client ID. The caller must supply their own secret for the run (or set NAVER_CLIENT_ID on the Actor). This secret is never written to the dataset, output, or logs. Placeholder example only: your-client-id." }, "naverClientSecret": { "title": "Naver Client Secret", "type": "string", "description": "Bring your own NAVER API HUB Client Secret. The caller must supply their own secret for the run (or set NAVER_CLIENT_SECRET on the Actor). This secret is never written to the dataset, output, or logs." } } }, "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 } } } } } } } } } }