{ "openapi": "3.0.1", "info": { "title": "Naver Blog Scraper — Sponsored Ad Detector + Keyword Volume", "description": "Scrape Naver Blog posts by keyword: full content, tags, sponsored-vs-내돈내산 ad detection, monthly keyword search volume and blogger rankings. Korean-native classifier. Unofficial tool, not affiliated with Naver.", "version": "1.0", "x-build-id": "DMTppVfSsI848aGw8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ntriqpro~naver-blog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ntriqpro-naver-blog-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/ntriqpro~naver-blog-scraper/runs": { "post": { "operationId": "runs-sync-ntriqpro-naver-blog-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/ntriqpro~naver-blog-scraper/run-sync": { "post": { "operationId": "run-sync-ntriqpro-naver-blog-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": { "keywords": { "title": "Search keywords", "type": "array", "description": "One or more keywords to search on Naver Blog. Korean keywords return the richest results (e.g. 제주도 맛집), English works too. Each keyword returns up to 1,000 posts plus its monthly search-volume rows and a blogger ranking. Max 10 keywords per run.", "items": { "type": "string" } }, "postUrls": { "title": "Direct post URLs (optional)", "type": "array", "description": "Specific Naver Blog post URLs to scrape directly (blog.naver.com/{blogId}/{logNo} or m.blog.naver.com links). Combine freely with keywords. Max 100 per run.", "items": { "type": "string" } }, "maxPostsPerKeyword": { "title": "Posts per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many posts to collect for each keyword. 1-1000 (Naver's search pagination ceiling). Fetching full content takes roughly 0.2-0.4s per post at the default concurrency." }, "sort": { "title": "Sort order", "enum": [ "sim", "date" ], "type": "string", "description": "Relevance (sim) or newest first (date).", "default": "sim" }, "fetchContent": { "title": "Fetch full post content", "type": "boolean", "description": "On by default: each post's full body text, hashtags and image count are extracted, and the sponsored/authentic classifier runs on the full text. Turn off for a faster metadata-only run (the classifier then sees only title and snippet)." }, "includeKeywordStats": { "title": "Include keyword search-volume rows", "type": "boolean", "description": "On by default: for each keyword, adds rows with monthly PC/mobile search volume, average clicks and competition level (from Naver's advertising keyword tool), including related keywords." }, "includeBloggerStats": { "title": "Include blogger ranking rows", "type": "boolean", "description": "On by default: for each keyword, adds a ranking of the bloggers behind the collected posts — post count, sponsored ratio, latest post date." }, "maxConcurrency": { "title": "Max concurrent content fetches", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel workers for post-content fetching. 1-10. The default is polite to Naver's servers." }, "maxResults": { "title": "Max result rows", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many billable rows (all row types combined). 1-5000." }, "maxRunSecs": { "title": "Run time budget (seconds)", "minimum": 60, "maximum": 21600, "type": "integer", "description": "Soft deadline for the whole run. When reached, the run stops fetching and returns everything collected so far as a successful run. 60-21600." } } }, "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 } } } } } } } } } }