{ "openapi": "3.0.1", "info": { "title": "Naver Scraper API – 네이버 Blog, News, Place & Map Reviews, KiN", "description": "Naver API & scraper, no login: Naver blog search & posts, Naver news search, ranking, articles (sports too) & comments, Naver Place & Naver Map search, reviews, details, KiN Q&A, web search SERP, autocomplete, DataLab keywords, webtoons, stocks (네이버 블로그·뉴스·플레이스·지도 리뷰). JSON. From $0.0005/row.", "version": "2.1", "x-build-id": "I2vo56lxVEchvghql" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deadc0dex~naver-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deadc0dex-naver-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/deadc0dex~naver-scraper/runs": { "post": { "operationId": "runs-sync-deadc0dex-naver-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/deadc0dex~naver-scraper/run-sync": { "post": { "operationId": "run-sync-deadc0dex-naver-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", "properties": { "operation": { "title": "Operation (Naver blog, news, Place reviews, KiN, search, autocomplete…)", "enum": [ "auto", "blog_search", "blog_posts", "blog_user_posts", "news_search", "news_ranking", "news_articles", "news_comments", "kin_search", "kin_questions", "web_search", "autocomplete", "place_search", "place_details", "place_reviews", "shopping_keywords", "webtoons", "stock_quotes", "capabilities" ], "type": "string", "description": "auto (default): blog/news/KiN/place URLs -> full item, place ids -> place_details, KRX codes -> stock_quotes, users -> blog_user_posts, keywords -> blog_search, nothing -> news_ranking. blog_search, news_search, kin_search, web_search, autocomplete, place_search take keywords. blog_posts, news_articles, news_comments, kin_questions take urls. place_details, place_reviews take ids/urls. shopping_keywords takes categories. webtoons, news_ranking need nothing. capabilities = free manifest.", "default": "auto" }, "keywords": { "title": "Keywords (Naver search terms)", "type": "array", "description": "Search terms for blog_search, news_search, kin_search, web_search, autocomplete, place_search (and company names for stock_quotes). Korean works best; common English terms are auto-translated (Gangnam restaurants -> 강남 맛집; see queryUsed). URLs placed here are treated as urls. Example: [\"제주 맛집\", \"Samsung Electronics\"].", "items": { "type": "string" } }, "urls": { "title": "URLs (Naver blog posts, news articles, KiN questions, places)", "type": "array", "description": "Naver links: blog.naver.com//, n.news.naver.com/mnews/article// (also m.sports / m.entertain articles), kin.naver.com/qna/detail.naver?…docId=…, m.place.naver.com//, map.naver.com/p/entry/place/, naver.me short links. Used by blog_posts, news_articles, news_comments, kin_questions, place_details, place_reviews. Cafe and Shopping links return an UNSUPPORTED_OPERATION row.", "items": { "type": "string" } }, "ids": { "title": "IDs (place ids, KRX stock codes, news oid/aid)", "type": "array", "description": "Naver Place ids (digits in map.naver.com/p/entry/place/) for place_details / place_reviews; 6-digit KRX codes for stock_quotes (005930 = Samsung Electronics); news ids as \"oid/aid\" (008/0005425552) for news_articles / news_comments.", "items": { "type": "string" } }, "users": { "title": "Bloggers (Naver blog ids or blog URLs)", "type": "array", "description": "Blog ids (the part after blog.naver.com/) or blog URLs for blog_user_posts: latest 50 public posts per blog via its RSS.", "items": { "type": "string" } }, "maxItems": { "title": "Max rows in total (billable)", "type": "integer", "description": "Stop after this many billable rows in total, nested comments/reviews included. Default 50, range 1-5000 (values outside are clamped). Error, summary, plan and capabilities rows are free and not counted.", "default": 50 }, "maxItemsPerInput": { "title": "Max rows per keyword / URL / place", "type": "integer", "description": "Cap per input (keyword, article, place, blogger, category). Default min(maxItems, 20), range 1-1000. Blog search pages 30 rows, news/KiN 10, places 50, reviews 50, comments 100 per request; the Actor pages automatically." }, "include": { "title": "Include (fullText, comments, reviews, details, reviewStats, insights)", "type": "array", "description": "fullText: open each blog/news/KiN search row (billed as post). comments: comment rows per news article (commentsPerItem). reviews: visitor review rows per place (reviewsPerPlace). details: hours, menu, amenities on place_search rows (same price). reviewStats: Naver review summary on place rows (avg rating, top voted keywords, menu mentions; same price). insights: one free row: top terms, review keywords, heuristic sentiment. Example: [\"fullText\",\"comments\",\"insights\"].", "items": { "type": "string" } }, "fields": { "title": "Fields (projection)", "type": "array", "description": "Return only these keys (plus type). Any field of the row type is allowed, e.g. [\"title\",\"url\",\"publishedAt\"]. Unknown names are reported in the summary warnings. Field lists per row type: operation capabilities.", "items": { "type": "string" } }, "outputMode": { "title": "Output mode", "enum": [ "compact", "full", "lean", "table" ], "type": "string", "description": "compact (default): envelope (type, operation, input, queryUsed, id, url, fetchedAt) + core fields, null when unknown. full: every field. lean: fewest tokens, no null/empty keys, text cut to maxTextChars (160). table: lean rows + one TSV table per row type in record LEAN_TABLE.", "default": "compact" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date", "comments" ], "type": "string", "description": "relevance (default) or date (newest first) for blog_search, news_search, kin_search. news_comments: relevance = most liked, date = newest. news_ranking: comments = most-commented ranking instead of most-viewed.", "default": "relevance" }, "dateFrom": { "title": "Date from", "type": "string", "description": "Start date: 2026-10-01, ISO date-time, or relative 7d / 24h / 3m (KST). blog_search and news_search filter on Naver; reviews, comments, KiN and blogger posts are filtered locally; shopping_keywords period start; news_ranking = ranking of that day." }, "dateTo": { "title": "Date to", "type": "string", "description": "End date, same formats as dateFrom. shopping_keywords default period = last 7 days ending yesterday." }, "businessType": { "title": "Place business type", "enum": [ "", "place", "restaurant", "cafe", "hospital", "beauty", "hairshop", "accommodation", "attraction" ], "type": "string", "description": "place_search: keep only this business category; place_reviews: review type when the URL does not say it. restaurant, cafe, hospital, beauty, hairshop, accommodation, attraction, place (any). Empty = any." }, "categories": { "title": "Shopping Insight categories", "type": "array", "description": "shopping_keywords: 8-digit Naver Shopping category ids or names. 50000000 fashion clothing, 50000001 accessories, 50000002 beauty, 50000003 digital/appliances, 50000004 furniture, 50000005 baby, 50000006 food, 50000007 sports, 50000008 living/health, 50000009 leisure, 50005542 books. Sub-category ids work too.", "items": { "type": "string" } }, "sections": { "title": "News ranking press filter", "type": "array", "description": "news_ranking: keep only these presses (names like 연합뉴스, 조선일보 or 3-digit press ids like 001, 023). Empty = all ~80 presses (rank-1 articles of every press first).", "items": { "type": "string" } }, "maxCostUsd": { "title": "Max cost (USD)", "type": "number", "description": "Stop before the run's charges would exceed this amount, e.g. 0.10. Partial results stay valid; a BUDGET_REACHED row (free) says so. The platform max charge per run is respected too." }, "dryRun": { "title": "Dry run (free estimate)", "type": "boolean", "description": "Return free plan rows (tasks, estimated rows, cost, seconds) without fetching or billing anything.", "default": false }, "deltaKey": { "title": "Delta key (only new rows)", "type": "string", "description": "Monitoring: rows already returned by earlier runs with the same deltaKey are skipped and not billed (ids kept 60 days in the named key-value store naver-scraper-delta in your account). E.g. \"my-store-reviews\" for new place reviews or comments." }, "expandQuery": { "title": "Translate English keywords to Korean", "type": "boolean", "description": "Translate common English search terms to Korean with a curated dictionary (Gangnam restaurants -> 강남 맛집, Samsung Electronics -> 삼성전자). Unknown words stay as typed. Each row shows queryUsed.", "default": true }, "commentsPerItem": { "title": "Comments per article (include comments)", "type": "integer", "description": "With include [\"comments\"]: comment rows per news article. Default 20, max 1000.", "default": 20 }, "reviewsPerPlace": { "title": "Reviews per place (include reviews)", "type": "integer", "description": "With include [\"reviews\"]: visitor review rows per place. Default 20, max 1000.", "default": 20 }, "maxTextChars": { "title": "Max text characters", "type": "integer", "description": "Cut long text (post text, article body, review, question, answers) to this many characters. Default 0 = no cut (lean/table default 160). Cut rows get truncated: true." }, "includeAds": { "title": "Keep sponsored results", "type": "boolean", "description": "blog/news/web search: keep sponsored (power content) rows. Default false.", "default": false }, "device": { "title": "Shopping Insight device", "enum": [ "", "pc", "mobile" ], "type": "string", "description": "shopping_keywords filter: all (default), pc or mobile." }, "gender": { "title": "Shopping Insight gender", "enum": [ "", "f", "m" ], "type": "string", "description": "shopping_keywords filter: all (default), f or m." }, "ages": { "title": "Shopping Insight age groups", "type": "array", "description": "shopping_keywords filter: any of 10, 20, 30, 40, 50, 60. Empty = all ages.", "items": { "type": "string" } }, "timeUnit": { "title": "Shopping Insight time unit", "enum": [ "date", "week", "month" ], "type": "string", "description": "shopping_keywords aggregation: date (default), week or month.", "default": "date" }, "dedupe": { "title": "Dedupe", "type": "boolean", "description": "Drop duplicate rows within a run (same id). Default true.", "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 }, "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 } } } } } } } } } }