{
  "openapi": "3.0.1",
  "info": {
    "title": "Naver News Scraper (네이버 뉴스 · Search, Full Text, Rankings)",
    "description": "Enter keywords or article URLs and get Naver News (네이버 뉴스) articles as flat rows: title, publisher, publish and update time, Naver News URL, original URL, thumbnail, section and optional full text. Also section feeds, publisher lists, rankings and a new-articles-only monitoring mode.",
    "version": "0.1",
    "x-build-id": "j3hV0bRe4CRihNjY3"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/magenta_courser~naver-news-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-magenta_courser-naver-news-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/magenta_courser~naver-news-scraper/runs": {
      "post": {
        "operationId": "runs-sync-magenta_courser-naver-news-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/magenta_courser~naver-news-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-magenta_courser-naver-news-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": "Keywords",
            "type": "array",
            "description": "Search keywords, one per line, exactly as you would type them into Naver News search. Korean keywords return the most results, e.g. 삼성전자 (Samsung Electronics), 반도체 수출 (chip exports), or a brand or person name. Each keyword is searched separately. Required unless you fill Article URLs, Sections, Publisher codes or Ranking instead.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Max results per keyword",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum rows for each keyword (1-1000). Default 100. The same limit applies to each section, each publisher and each ranking. Naver lists about 1,000 results per search, so to go further back split the period with dateFrom/dateTo and run once per period.",
            "default": 100
          },
          "sort": {
            "title": "Sort (keyword search)",
            "enum": [
              "recent",
              "relevance",
              "oldest"
            ],
            "type": "string",
            "description": "Order of keyword search results: recent (newest first, default; required for monitoring to stop at the previous run), relevance (Naver's relevance ranking) or oldest (oldest first).",
            "default": "recent"
          },
          "includeArticleContent": {
            "title": "Include full article text",
            "type": "boolean",
            "description": "false (default) = list data only: title, publisher, snippet, time, links. true = also open every found article on Naver News and add its full text (content), exact publish and update minute, section(s), image URLs and the publisher's original URL. Only articles that have a copy on Naver News can be opened; the others keep their row with contentStatus unsupported. One extra page load per article, so runs take longer.",
            "default": false
          },
          "articleUrls": {
            "title": "Article URLs",
            "type": "array",
            "description": "Optional. Naver News article addresses to read in full, one per line, no keyword needed. Accepts https://n.news.naver.com/article/<publisher>/<article>, .../mnews/article/..., m.news.naver.com and news.naver.com links, Naver Sports and Naver Entertainment article links, old read.naver?oid=..&aid=.. links, or just 001/0016436704. Each readable article becomes one row with full text; addresses that cannot be read are listed with the reason in RUN_SUMMARY and are not charged.",
            "items": {
              "type": "string"
            }
          },
          "sections": {
            "title": "Sections",
            "type": "array",
            "description": "Optional. Naver News sections to read: the section's current headlines followed by its article feed (newest first as Naver lists it). Any of: politics (정치), economy (경제), society (사회), culture (생활/문화), world (세계), science (IT/과학).",
            "items": {
              "type": "string",
              "enum": [
                "politics",
                "economy",
                "society",
                "culture",
                "world",
                "science"
              ],
              "enumTitles": [
                "Politics (정치)",
                "Economy (경제)",
                "Society (사회)",
                "Life & Culture (생활/문화)",
                "World (세계)",
                "IT & Science (IT/과학)"
              ]
            }
          },
          "pressIds": {
            "title": "Publisher codes",
            "type": "array",
            "description": "Optional. Naver News publisher (press) codes or publisher page addresses, one per line, e.g. 001 (Yonhap News), 015 (Korea Economic Daily) or https://media.naver.com/press/001. Returns that publisher's articles on Naver News newest first, day by day (the last 7 days unless you set dates). If Ranking is also set, returns that publisher's ranking instead (up to 20 articles with view or comment counts).",
            "items": {
              "type": "string"
            }
          },
          "ranking": {
            "title": "Ranking",
            "enum": [
              "none",
              "mostViewed",
              "mostCommented"
            ],
            "type": "string",
            "description": "Optional. none (default), mostViewed (많이 본 뉴스) or mostCommented (댓글 많은 뉴스). Without Publisher codes: Naver's ranking page with the top 5 articles of about 80 publishers (about 400 rows, so raise Max results to 500 to get all). With Publisher codes: each publisher's top 20 with the view count or comment count Naver shows.",
            "default": "none"
          },
          "daysBack": {
            "title": "Last N days",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Optional. Only articles from the last N days, counted in Korea time: 0 = today only, 1 = yesterday and today, 7 = the last week. Stays correct in a schedule because it moves with the run date. Applies to keyword searches and publisher lists. Do not combine with dateFrom."
          },
          "dateFrom": {
            "title": "Published from",
            "type": "string",
            "description": "Optional. Only articles published on or after this date, Korea time, format YYYY-MM-DD, e.g. 2026-09-01. Applies to keyword searches and publisher lists. If only dateTo is set, dateFrom defaults to 2000-01-01."
          },
          "dateTo": {
            "title": "Published to",
            "type": "string",
            "description": "Optional. Only articles published on or before this date, Korea time, format YYYY-MM-DD, e.g. 2026-09-15. If only dateFrom is set, dateTo defaults to today."
          },
          "onlyNewSinceLastRun": {
            "title": "Only new articles since the last run",
            "type": "boolean",
            "description": "Monitoring mode. true = return only articles this Actor has not returned before for the same list (same keyword, sort and date range, or the same section, publisher or ranking; remembered in the history store below). The first run returns the latest articles as usual. Use with sort recent and a schedule (e.g. hourly or daily). Best effort, not a guarantee of complete coverage: articles that Naver lists later than lookbackHours after their publish time, or more new articles than Max results between runs, can be missed. Default false.",
            "default": false
          },
          "lookbackHours": {
            "title": "Overlap with the previous run (hours)",
            "minimum": 0,
            "maximum": 720,
            "type": "integer",
            "description": "Only used when onlyNewSinceLastRun is true. Each run re-checks articles dated up to this many hours before the previous complete run started, so articles that appear in Naver late are still returned once. Larger = fewer missed late articles, a few more pages read (pages are not charged, only returned rows). 0-720, default 48.",
            "default": 48
          },
          "historyStoreName": {
            "title": "History store name",
            "type": "string",
            "description": "Only used when onlyNewSinceLastRun is true. Name of the key-value store in your Apify account that remembers already returned articles. Inside it every list has its own record, so different searches never share history. Use a separate name for each separate monitor, e.g. brand-news-hourly, and do not run the same monitor twice at the same time (it can return some articles twice). Letters, digits and hyphens only, max 63 characters.",
            "default": "naver-news-monitor-history"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Proxy settings. The default Apify datacenter proxy works for Naver News. Switch to RESIDENTIAL with country KR only if the log shows repeated request errors.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}