{ "openapi": "3.0.1", "info": { "title": "Naver Search Scraper — Korean SERP, Powerlink & Rank Tracker", "description": "Naver search scraper for Korean 통합검색 rank tracking. Extract Powerlink ads, blog, cafe, 지식iN, news, Place, shopping, and web as one row per result with block type and position. PC and mobile layouts, batch keywords, JSON export for Python, Node.js, and MCP.", "version": "1.0", "x-build-id": "z0jf5cPEfkZ7m9neE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~naver-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-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/crawloop~naver-search-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-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/crawloop~naver-search-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-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": { "query": { "title": "Search query", "type": "string", "description": "Primary Naver search keyword or phrase (Korean or English)." }, "queries": { "title": "Search queries (batch)", "type": "array", "description": "Optional list of keywords. Each query uses the same device, ads, and block-type settings. Up to 4 queries can run in parallel (`maxConcurrency`).", "items": { "type": "string" } }, "searchUrls": { "title": "Naver search URLs", "type": "array", "description": "Paste search.naver.com or m.search.naver.com URLs. Query and PC/mobile are read from the URL.", "items": { "type": "string" } }, "device": { "title": "Device layout", "enum": [ "pc", "mobile", "both" ], "type": "string", "description": "Which 통합검색 layout to scrape. `both` runs PC then mobile for every keyword.", "default": "pc" }, "maxItems": { "title": "Max results per query", "minimum": 1, "type": "integer", "description": "Optional cap on SERP rows saved per keyword and device. Rank order is preserved." }, "includeAds": { "title": "Include Powerlink / shopping ads", "type": "boolean", "description": "Keep paid placements (Powerlink and shopping AD cards). Turn off to save organic blocks only.", "default": true }, "blockTypes": { "title": "Block types", "type": "array", "description": "Optional filter. When empty, every parsed 통합검색 block is saved. Use to keep only Powerlink, blog, Place, etc.", "items": { "type": "string", "enum": [ "powerlink", "blog", "cafe", "kin", "news", "place", "shopping", "web", "influencer", "video", "ai_overview" ], "enumTitles": [ "Powerlink ads", "Blog", "Cafe", "지식iN", "News", "Place", "Shopping", "Web", "Influencer", "Video / clip", "AI overview" ] } }, "deduplicateUrls": { "title": "Deduplicate URLs", "type": "boolean", "description": "When enabled, each destination URL is saved only once across all queries in the run.", "default": true }, "maxConcurrency": { "title": "Query concurrency", "minimum": 1, "maximum": 4, "type": "integer", "description": "How many keyword/device jobs to scrape in parallel (1–4). Each job uses its own sticky KR residential session. Default 2.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. KR residential is strongly recommended for Naver 통합검색.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" } } } }, "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 } } } } } } } } } }