{
"openapi": "3.0.1",
"info": {
"title": "네이버 검색 스크래퍼 | Naver Search Scraper & AI Briefing",
"description": "Extract Naver (네이버) search results: web pages, news, blogs, cafes, 지식iN answers, video and clips from one Korean search term. Includes Naver's AI Briefing with every source it cited, plus its own query topic analysis. Advertising is always labelled. Export JSON, CSV or Excel.",
"version": "0.0",
"x-build-id": "mWIgUlfSIjaUiWven"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zen-studio~naver-search-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zen-studio-naver-search-scraper",
"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/zen-studio~naver-search-scraper/runs": {
"post": {
"operationId": "runs-sync-zen-studio-naver-search-scraper",
"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/zen-studio~naver-search-scraper/run-sync": {
"post": {
"operationId": "run-sync-zen-studio-naver-search-scraper",
"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": [
"queries"
],
"properties": {
"queries": {
"title": "검색어 (Search terms)",
"type": "array",
"description": "What to search for on Naver. Korean or English, one term per line.
Each term returns the whole results page: web pages, news, blogs, cafes, Knowledge iN answers, videos and clips, plus the AI briefing when Naver produces one.",
"items": {
"type": "string"
}
},
"verticals": {
"title": "결과 종류 (Result types)",
"type": "array",
"description": "Which kinds of result to collect. The default returns everything on the page at once, which is what most people want.
Pick individual types instead when you only care about one: a single type is a smaller, faster page.
지식iN and 인플루언서 always return one page of results; Naver offers no more than that for either.",
"items": {
"type": "string",
"enum": [
"integrated",
"web",
"news",
"blog",
"knowledgeIn",
"video",
"clip",
"cafe",
"influencer"
],
"enumTitles": [
"통합검색 (Everything on the page)",
"웹 (Web pages)",
"뉴스 (News)",
"블로그 (Blog)",
"지식iN (Knowledge iN)",
"동영상 (Video)",
"클립 (Clip)",
"카페 (Cafe)",
"인플루언서 (Influencer)"
]
},
"default": [
"integrated"
]
},
"maxResultsPerQuery": {
"title": "검색어당 최대 결과 수 (Max results per search term)",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "How many results to collect for each search term, across every result type you selected. Set to 0 for everything Naver will give.
The whole results page returns roughly 50 results per term in one go. Single types such as News or Blog go deeper, several hundred to a few thousand.",
"default": 100
},
"sortBy": {
"title": "정렬 (Result order)",
"enum": [
"relevance",
"recency"
],
"type": "string",
"description": "Best match is Naver's own ranking, and it is what every result type uses by default.
Only News honours newest-first. The other result types return Naver's ranking whatever you choose here, so this is left on best match unless you are collecting news.",
"default": "relevance"
},
"includeAiBriefing": {
"title": "AI 브리핑 포함 (Include the AI briefing)",
"type": "boolean",
"description": "Naver's AI-written answer for the search term, with the sources it cited and their publishers. It arrives as its own row alongside the results.
Naver produces one for roughly 4 in 10 terms, mostly health, legal, how-to and definition questions. You are only charged for briefings that actually arrive.",
"default": true
},
"includeQueryAnalysis": {
"title": "검색어 분석 포함 (Include query analysis)",
"type": "boolean",
"description": "Naver's own reading of the search term: what topic it thinks the term belongs to and how confident it is, the entities it recognised, and the intent it matched.
Free with the search, and available for roughly 1 term in 4. Nothing extra is charged for it.",
"default": true
},
"includeAds": {
"title": "광고 포함 (Include advertising)",
"type": "boolean",
"description": "Naver mixes paid placements into its results. They are always marked with isAdvertising, never passed off as organic. Switch this off to drop them entirely.",
"default": true
}
}
},
"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
}
}
}
}
}
}
}
}
}
}