API 요청
/rest/dart_disclosure요청 파라미터 5개
corpCode- 예시
00126380
startDate- 예시
20260101
endDate- 예시
20260331
pageNonumOfRows응답 필드 9개
datadata.itemsdata.totalCountdata.pageNodata.numOfRowsapiapi.costapi.successapi.ms회사 고유번호·기간·공시유형으로 전자공시 목록을 조회합니다. 고유번호를 주면 회사의 공시를 기간으로 좁혀 보고, 고유번호 없이 기간만 주면 전체 공시를 훑습니다.
https://apick.app/rest/dart_disclosure왜 공시 이벤트 분석인가
기업 공시는 하루에도 여러 건이 올라와 직접 확인하면 놓치기 쉽습니다. 기간과 대상을 넘겨 공시 목록과 유형을 받아 투자·거래 판단에 바로 씁니다.
성공한 조회 한 건당 50P가 차감됩니다. 결과가 0건이면 data.error로 안내 문구가 오고 api.cost는 0입니다. 실제 차감액은 응답의 api.cost에서 확인하세요.
고유번호 없이 기간만 지정하면 조회 기간은 최대 3개월입니다. 고유번호를 주면 기간 제한 없이 조회할 수 있습니다.
인증키는 서버 환경변수에 보관하고 공개 저장소·웹페이지에 넣지 마세요.
/rest/dart_disclosurecorpCode00126380startDate20260101endDate20260331pageNonumOfRowsdatadata.itemsdata.totalCountdata.pageNodata.numOfRowsapiapi.costapi.successapi.msPOST https://apick.app/rest/dart_disclosureAuthorization: Bearer — 내 계정의 API 인증키multipart/form-datacorpCode 고유번호 8자리, startDate·endDate 조회 기간(YYYYMMDD), pblntfTy 공시유형(A 정기·B 주요사항·C 발행·D 지분·E 기타·F 외부감사·G 펀드·H 자산유동화·I 거래소·J 공정거래), pageNo 페이지(기본 1), numOfRows 결과 수(기본 10, 최대 100)고유번호로 한 회사의 1분기 공시를 받는 예입니다. 성공 시 과금되는 실제 요청입니다.
HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.{
"data": {
"error": "입력값을 확인해 주세요.",
"success": 0
},
"api": {
"success": true,
"cost": 0,
"ms": 5
}
}{
"data": { "items": [], "totalCount": 0, "pageNo": 1, "numOfRows": 10 },
"api": { "cost": 50, "success": true, "ms": 300 }
}
날짜 형식이 맞지 않거나 고유번호가 8자리가 아니면 조회 전에 data.error로 실패합니다. 결과가 없으면 조회된 데이터가 없습니다.가 오고 api.cost는 0이며, 공시 정보를 가져오지 못하면 공개 안내 문구가 옵니다. 기간을 넓힐 때는 pageNo로 나눠 받으세요.
FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.
같은 요청을 JavaScript와 Python으로 옮긴 예시입니다. 키는 환경변수 APICK_API_KEY 에서 읽습니다.