search_disclosures

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "corp": {
      "description": "회사명/종목코드/corp_code. Omit for all companies — but a batch without corp splits the period into 90-day chunks and sweeps every company, spending up to the per-call request budget (default 60, env SEARCH_MAX_REQUESTS) and taking tens of seconds; on reaching it collection is truncated and flagged incomplete=true. With corp the split disappears and the same query finishes in 1 request and a few hundred ms.",
      "type": "string"
    },
    "start": {
      "description": "Start date YYYY-MM-DD. When omitted, `days` back from today (and when that is unset, the preset default: 사업·감사 460 / 반기 280 / 분기 180 / 수시·일반 90) — set it explicitly for older filings. (The old parameter name begin is still accepted — unified with start/end in get_corporate_event.)",
      "type": "string"
    },
    "end": {
      "description": "End date (defaults to today)",
      "type": "string"
    },
    "days": {
      "description": "Trailing N days from today instead of start (1~730; out-of-range values are clamped to the bound). When unset, the preset default applies: 사업·감사 460 / 반기 280 / 분기 180 / 수시·일반 90. For windows longer than 730 days use start/end",
      "type": "integer",
      "minimum": 1,
      "maximum": 730
    },
    "kind": {
      "description": "공시유형: periodic/major/issuance/holdings/audit/other/fund/abs/exchange/ftc",
      "type": "string",
      "enum": [
        "periodic",
        "major",
        "issuance",
        "holdings",
        "other",
        "audit",
        "fund",
        "abs",
        "exchange",
        "ftc"
      ]
    },
    "preset": {
      "description": "22 presets: treasury_buy/sell/trust · cb/bw/eb_issue · rights_offering/bonus_issue/capital_reduction · merger/split/stock_exchange · business_transfer/acquisition · large_holding_5pct · annual_report/half_report/quarterly_report · audit_report · correction_all · insolvency · litigation. Setting one applies kind and a keyword filter automatically and collects every page in parallel.",
      "type": "string",
      "enum": [
        "treasury_buy",
        "treasury_sell",
        "treasury_trust",
        "cb_issue",
        "bw_issue",
        "eb_issue",
        "rights_offering",
        "bonus_issue",
        "capital_reduction",
        "merger",
        "split",
        "stock_exchange",
        "business_transfer",
        "business_acquisition",
        "large_holding_5pct",
        "annual_report",
        "half_report",
        "quarterly_report",
        "audit_report",
        "correction_all",
        "insolvency",
        "litigation"
      ]
    },
    "final_only": {
      "default": false,
      "description": "One latest version per event — where a 정정 exists the 구본(원본) is dropped and the latest 정정본 is taken (this does NOT exclude 정정공시 themselves). Use when you need one duplicate-free set.",
      "type": "boolean"
    },
    "include_corrections": {
      "default": false,
      "description": "Whether to include 정정공시 ([기재정정] etc.) — preset batch mode ONLY (default false, to avoid double-counting 원본+정정 of the same event; correction_all forces true; ignored when final_only=true since that already removes duplicates). Bare all_pages and page mode ALWAYS include them (raw DART) — for latest-only without duplicates use final_only.",
      "type": "boolean"
    },
    "all_pages": {
      "default": false,
      "description": "Collect the whole period in parallel even without a preset (정정공시 included — the same set as page mode). When true, limit applies instead of page/size.",
      "type": "boolean"
    },
    "page": {
      "default": 1,
      "description": "Page number (page mode — the default when neither preset nor all_pages is set). Row shape differs by mode: page mode items are raw DART list rows, batch mode items a 7-key projection (rcept_no·rcept_dt·corp_name·corp_code·corp_cls·report_nm·flr_nm), so any field outside those 7 is only in page mode.",
      "type": "integer",
      "minimum": 1
    },
    "size": {
      "default": 20,
      "description": "Page size (page mode)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "limit": {
      "default": 500,
      "description": "Cap on rows finally returned in batch mode (preset given or all_pages=true)",
      "type": "integer",
      "minimum": 1,
      "maximum": 3000
    },
    "concurrency": {
      "default": 5,
      "description": "Collector workers in batch mode (1~10, default 5). **Effective concurrency is set by a server-wide cap, so raising this usually does NOT make it faster** — to cut latency, set corp (which removes the period split, leaving a single request), narrow the period, or lower limit. The response's dart_requests/cached_chunks report how many DART requests this call spent and how many chunks came from cache — read them when it feels slow.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  }
}