{ "openapi": "3.0.1", "info": { "title": "Naver AI Overview Monitor — Briefing & Brand Match", "description": "Monitor Naver AI Briefing (AI Overview) for Korean search queries, with AI answer text, cited sources, related questions, media and optional brand or domain match. Collected through Korean residential proxies, with an optional bring-your-own search API key.", "version": "0.1", "x-build-id": "WQdOzOOAMoEgLQqgv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~naver-ai-overview-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-naver-ai-overview-monitor", "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/khadinakbar~naver-ai-overview-monitor/runs": { "post": { "operationId": "runs-sync-khadinakbar-naver-ai-overview-monitor", "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/khadinakbar~naver-ai-overview-monitor/run-sync": { "post": { "operationId": "run-sync-khadinakbar-naver-ai-overview-monitor", "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": "Single search query", "type": "string", "description": "One Korean or English query for Naver AI Briefing (e.g. '당뇨병 증상'). Provide this, queries, or both. Informational question-style queries trigger briefings most often. NOT a full search.naver.com URL." }, "queries": { "title": "Search queries (batch)", "minItems": 0, "maxItems": 50, "type": "array", "description": "Batch of queries for one run. Merged with query and de-duplicated. Max 50. One dataset row per query. NOT Google queries — these hit search.naver.com.", "items": { "type": "string" } }, "targetDomain": { "title": "Brand domain to detect (optional)", "type": "string", "description": "Bare domain(s) to match against briefing citations (e.g. 'amoremall.com' or comma-separated). When set, output includes brandMatch. Leave empty to skip domain matching. NOT a full URL." }, "brandNames": { "title": "Brand name strings (optional)", "type": "array", "description": "Case-insensitive brand name strings to scan in answer text and citation titles/snippets (e.g. ['설화수']). Complements targetDomain. Max 20.", "items": { "type": "string" } }, "device": { "title": "Device emulation", "enum": [ "desktop", "mobile" ], "type": "string", "description": "Viewport to emulate. Defaults to desktop. Only desktop or mobile.", "default": "desktop" }, "includeRelatedQuestions": { "title": "Include related questions", "type": "boolean", "description": "Include Naver follow-up / related questions when present. Defaults to true.", "default": true }, "includeMedia": { "title": "Include related media", "type": "boolean", "description": "Include media thumbnails attached to the briefing when present. Defaults to true.", "default": true }, "serpApiKey": { "title": "SerpApi key (BYOK fallback, optional)", "type": "string", "description": "Optional SerpApi.com key for engine=naver_ai_overview when the browser route is access-restricted. The caller must supply their own SerpApi key for the run; the value is never written to the dataset, output, or logs. Free tier at serpapi.com. Leave empty for the browser route only. NOT a Naver Open API key." }, "maxRetries": { "title": "Max retries per query", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries after the managed browser route navigation failures. Defaults to 2.", "default": 2 }, "forceSerpapi": { "title": "Skip the browser, use your own search API key directly", "type": "boolean", "description": "Skip the browser route and call the search API with the key you supply above. Requires that key. Defaults to false.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Defaults to Apify RESIDENTIAL with country KR. Datacenter proxies are usually blocked by 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 }, "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 } } } } } } } } } }