{ "openapi": "3.0.1", "info": { "title": "Naver Search Scraper - Blog, Cafe, News & Web Results", "description": "Scrape Naver search results from the All (통합), Blog, Cafe, News, Q&A (지식iN) and Video tabs with the website's filters: sort, period, custom dates, publisher, cafe trade posts, video length and more. Up to about 1,000 results per tab, one row per result. No API key.", "version": "0.0", "x-build-id": "845i4fAJTg7hgnmll" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delicious_zebu~naver-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delicious_zebu-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/delicious_zebu~naver-search-scraper/runs": { "post": { "operationId": "runs-sync-delicious_zebu-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/delicious_zebu~naver-search-scraper/run-sync": { "post": { "operationId": "run-sync-delicious_zebu-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", "properties": { "queries": { "title": "Search terms (검색어)", "type": "array", "description": "One search term per line, the same as you would type into the Naver search box. Naver's search operators work too: \"exact phrase\", +must-have, -exclude, word1 | word2. You can also paste a search.naver.com search link: its tab and filters are used as they are.", "items": { "type": "string" } }, "max_results": { "title": "Max results per search term and tab", "minimum": 0, "type": "integer", "description": "How many results to take from each tab for each search term, from the top. Use 0 for all that Naver shows: up to about 1,000 per tab (통합 shows about 170). 파워링크 ads are not counted.", "default": 100 }, "start_date": { "title": "Custom period: start date", "type": "string", "description": "Used by every tab whose 기간 (period) is set to 직접입력 (custom dates). Example: 2026-09-01." }, "end_date": { "title": "Custom period: end date", "type": "string", "description": "End of the custom period (included). Leave empty for today. Example: 2026-09-30." }, "all_tab": { "title": "Scrape 통합 (All results)", "type": "boolean", "description": "The main Naver results page: web pages, blogs, cafe posts and videos mixed, about 170 results over 10 pages. Topic blocks on the first page (클립, 인플루언서, images, places) are not included.", "default": true }, "all_sort": { "title": "정렬 (Sort)", "enum": [ "relevance", "latest" ], "type": "string", "description": "Like 정렬 in the 통합 옵션 panel.", "default": "relevance" }, "all_period": { "title": "기간 (Period)", "enum": [ "all", "1h", "1d", "1w", "1m", "3m", "6m", "1y", "custom" ], "type": "string", "description": "Only results posted in this period, like 기간 in the 통합 tab's 옵션 panel. 직접입력 uses the start and end dates at the top of the form.", "default": "all" }, "all_ads": { "title": "Include 파워링크 ads", "type": "boolean", "description": "Also save the paid ads at the top of the first 통합 page (관련 광고 / 파워링크): advertiser, ad title, text and display URL. They are numbered separately and not counted in the max results.", "default": false }, "blog_tab": { "title": "Scrape 블로그 (Blog)", "type": "boolean", "description": "Naver Blog and other blogs (such as Tistory) that Naver search shows in the 블로그 tab.", "default": false }, "blog_sort": { "title": "정렬 (Sort)", "enum": [ "relevance", "latest" ], "type": "string", "description": "Like 정렬 in the 블로그 옵션 panel.", "default": "relevance" }, "blog_period": { "title": "기간 (Period)", "enum": [ "all", "1h", "1d", "1w", "1m", "3m", "6m", "1y", "custom" ], "type": "string", "description": "Only posts posted in this period, like 기간 in the 블로그 tab's 옵션 panel. 직접입력 uses the start and end dates at the top of the form.", "default": "all" }, "blog_full_text": { "title": "Blog full text", "type": "boolean", "description": "Also open each Naver Blog post (blog.naver.com) to get its full text and exact publish time. One extra request per post, so it is slower. Other blogs and ads are skipped.", "default": false }, "cafe_tab": { "title": "Scrape 카페 (Cafe)", "type": "boolean", "description": "Naver Cafe posts from the 카페 tab, with the comments that Naver shows under them.", "default": false }, "cafe_target": { "title": "대상 (Post type)", "enum": [ "all", "trade", "general", "cafe_name" ], "type": "string", "description": "Like 대상 in the 카페 옵션 panel. 거래글 = buy/sell posts, 일반글 = other posts. 카페명 finds cafes by name instead of posts (one row per cafe with members and post counts).", "default": "all" }, "cafe_sort": { "title": "정렬 (Sort)", "enum": [ "relevance", "latest" ], "type": "string", "description": "Like 정렬 in the 카페 옵션 panel.", "default": "relevance" }, "cafe_period": { "title": "기간 (Period)", "enum": [ "all", "1h", "1d", "1w", "1m", "3m", "6m", "1y", "custom" ], "type": "string", "description": "Only posts posted in this period, like 기간 in the 카페 tab's 옵션 panel. 직접입력 uses the start and end dates at the top of the form.", "default": "all" }, "cafe_trade_method": { "title": "거래방법 (Payment)", "enum": [ "all", "safe", "direct" ], "type": "string", "description": "For trade posts: 안전거래 = Naver safe payment, 일반거래 = direct deal. Like 거래방법 in the 카페 옵션 panel.", "default": "all" }, "cafe_trade_status": { "title": "거래상태 (Trade status)", "enum": [ "all", "selling", "sold" ], "type": "string", "description": "For trade posts: still for sale or already sold. Like 거래상태 in the 카페 옵션 panel.", "default": "all" }, "news_tab": { "title": "Scrape 뉴스 (News)", "type": "boolean", "description": "News articles from the 뉴스 tab, with the publisher, the Naver News link and related articles.", "default": false }, "news_sort": { "title": "정렬 (Sort)", "enum": [ "relevance", "latest", "oldest" ], "type": "string", "description": "Like 정렬 in the 뉴스 옵션 panel.", "default": "relevance" }, "news_service_area": { "title": "서비스 영역 (Publishers on Naver main)", "enum": [ "all", "mobile_main", "pc_main" ], "type": "string", "description": "Only publishers shown on the Naver mobile or PC main page. Like 서비스 영역 in the 뉴스 옵션 panel.", "default": "all" }, "news_period": { "title": "기간 (Period)", "enum": [ "all", "1h", "2h", "3h", "4h", "5h", "6h", "1d", "1w", "1m", "3m", "6m", "1y", "custom" ], "type": "string", "description": "Only articles posted in this period, like 기간 in the 뉴스 tab's 옵션 panel. 직접입력 uses the start and end dates at the top of the form.", "default": "all" }, "news_type": { "title": "유형 (Type)", "enum": [ "all", "photo", "video", "print", "press_release", "auto" ], "type": "string", "description": "Like 유형 in the 뉴스 옵션 panel. 지면기사 = articles from the print edition (the page, such as A4면, is saved).", "default": "all" }, "news_press_type": { "title": "언론사 유형 (Publisher type)", "enum": [ "all", "daily", "broadcast", "economy_it", "internet", "sports_entertainment", "local", "magazine", "specialized" ], "type": "string", "description": "Only publishers of this type, like 언론사 → 유형별 in the 뉴스 옵션 panel. Ignored when a publisher name is filled in.", "default": "all" }, "news_press_name": { "title": "언론사 (Publisher name)", "type": "string", "description": "Only articles from this publisher, like picking one in 언론사 in the 뉴스 옵션 panel. Write its name as on Naver, e.g. 조선일보, 연합뉴스, 한국경제. One publisher at a time." }, "news_reporters": { "title": "기자명 (Reporter names)", "type": "array", "description": "Search articles by reporter name, like 기자명 in the 뉴스 옵션 panel: each name is searched on its own (the search terms are not used for it). Works with the other 뉴스 filters. Example: 김민수.", "items": { "type": "string" } }, "kin_tab": { "title": "Scrape 지식iN (Q&A)", "type": "boolean", "description": "Questions and answers from Naver 지식iN, with the answerer and their badge.", "default": false }, "kin_period": { "title": "기간 (Period)", "enum": [ "all", "1h", "1d", "1w", "1m", "3m", "6m", "1y", "custom" ], "type": "string", "description": "Only questions posted in this period, like 기간 in the 지식iN tab's 옵션 panel. 직접입력 uses the start and end dates at the top of the form.", "default": "all" }, "kin_answer": { "title": "답변 (Answered by)", "enum": [ "all", "expert_plus", "expert", "lawyer", "patent_attorney", "judicial_scrivener", "labor_attorney", "accountant", "tax_accountant", "doctor", "oriental_doctor", "veterinarian", "pharmacist", "nutritionist", "exercise_expert", "claims_adjuster", "management_consultant", "technical_consultant", "engineer", "customs_broker", "knowledge_partner", "field_expert", "top_rank" ], "type": "string", "description": "Only questions answered by this kind of person, like 답변 in the 지식iN 옵션 panel.", "default": "all" }, "video_tab": { "title": "Scrape 동영상 (Video)", "type": "boolean", "description": "Videos from YouTube, Naver TV, Naver Blog and more, with duration, views and channel. Short clips that Naver mixes into the list are included as type clip.", "default": false }, "video_sort": { "title": "정렬 (Sort)", "enum": [ "relevance", "latest", "views" ], "type": "string", "description": "Like 정렬 in the 동영상 옵션 panel.", "default": "relevance" }, "video_type": { "title": "유형 (Type)", "enum": [ "all", "shorts" ], "type": "string", "description": "숏폼 = short-form videos only. Like 유형 in the 동영상 옵션 panel.", "default": "all" }, "video_period": { "title": "기간 (Period)", "enum": [ "all", "1d", "1w", "1m", "3m", "6m", "1y", "custom" ], "type": "string", "description": "Only videos posted in this period, like 기간 in the 동영상 tab's 옵션 panel. 직접입력 uses the start and end dates at the top of the form.", "default": "all" }, "video_duration": { "title": "시간 (Length)", "enum": [ "all", "under_10m", "10m_30m", "30m_1h", "over_1h" ], "type": "string", "description": "Like 시간 in the 동영상 옵션 panel.", "default": "all" }, "video_play": { "title": "재생 (Playback)", "enum": [ "all", "inplay" ], "type": "string", "description": "바로재생 = only videos that play right on the Naver results page. Like 재생 in the 동영상 옵션 panel.", "default": "all" }, "video_source": { "title": "출처 (Source)", "enum": [ "all", "naver_all", "naver_cafe", "naver_blog", "naver_tv", "smartstore", "clip", "naver_blog_clip", "naver_news", "naver_kin", "chzzk", "naver_shopping_live", "youtube", "tiktok", "pullbbang", "soop", "jtbc", "weverse", "naver_official", "external_official" ], "type": "string", "description": "Only videos from this platform, like 출처 in the 동영상 옵션 panel.", "default": "all" } } }, "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 } } } } } } } } } }