공시 검색
search_disclosuresSearch corporate disclosures with built-in FTC presets. Filter by company, date, report type, and collect full-period records in batch mode.
Instructions
공시를 검색합니다. 공정위 기업집단 공시 프리셋이 내장되어 있습니다 (ftc_all=공정위 전체, internal_transaction=대규모내부거래, group_status=기업집단현황, unlisted_material=비상장사 중요사항, public_interest_corp=공익법인, subcontract=하도급 결제조건).
mode:"page"(기본) = 한 페이지씩 조회. mode:"batch" = 기간 전체 전수 수집 (중복 제거·건수 집계 포함)
batch 가 한 번에 처리하기 큰 범위면 range_too_large 에러와 함께 분할 구간을 안내합니다 — 안내된 구간대로 나눠 다시 호출하세요
report_name_contains 로 보고서명을 거를 수 있습니다 (선례 검색: preset+["자금차입" 등])
응답의 diagnostics 를 반드시 확인하세요 — truncated/partial_results 가 true 면 결과가 불완전합니다
정정 이전 원본 접수분을 포함합니다 (last_report_only 기본 false — 지연 판정에 필수)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | page(기본)=한 페이지 조회. batch=적응형 분할 전수 수집 — 규모가 크면 range_too_large 와 분할 안내를 반환 | |
| page | No | mode:"page" 의 페이지 번호 (기본 1) | |
| limit | No | mode:"batch" 응답에 실을 최대 행수 (기본 200). 수집·집계는 전수로 하고 응답만 자릅니다 | |
| query | No | 회사명·종목코드(6자리)·corp_code(8자리)·법인등록번호(13자리). 동명 법인이 여럿이면 ambiguous_corp 에러와 후보 목록을 돌려줍니다 | |
| preset | No | 공정위 공시 프리셋. ftc_all=J 전체 / internal_transaction=대규모내부거래 / group_status=기업집단현황 / unlisted_material=비상장사 중요사항 / public_interest_corp=공익법인 / subcontract=하도급 결제조건 | |
| compact | No | true 면 schema+값 배열 형태로 토큰 30~40% 절감 (행이 많을 때 권장) | |
| date_to | No | 조회 종료일 YYYYMMDD (기본: 오늘) | |
| corp_cls | No | 법인구분 Y=유가 K=코스닥 N=코넥스 E=기타(비상장 대부분) | |
| corp_code | No | DART 법인코드 8자리 — query 대신 직접 지정 | |
| date_from | No | 조회 시작일 YYYYMMDD (기본: 30일 전) | |
| page_size | No | 페이지당 건수 (기본·최대 100) | |
| pblntf_ty | No | DART 공시유형 원시 코드 (preset 과 동시 지정 불가) | |
| last_report_only | No | ⚠️ 기본 false. true(최종보고서만)는 정정으로 대체된 원본 접수분을 지워 지연 판정이 불가능해집니다 | |
| pblntf_detail_ty | No | DART 공시상세유형 원시 코드 (preset 과 동시 지정 불가) | |
| report_name_contains | No | 보고서명 부분일치 필터 — 서버 필터가 아니라 수집 후 적용됩니다 (예: "자금차입", "기재정정") |