> For the complete documentation index, see [llms.txt](https://docs.dfinery.ai/api-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dfinery.ai/api-guide/api/export-api/export/post-report.md).

# POST: 리포트 추출

<mark style="color:green;">`POST`</mark> `api/v1/export/report`

적재되어있는 캠페인 리포트를 추출할 수 있는 API 입니다.

{% hint style="warning" %}
이벤트 데이터 추출은 현재 날짜로부터 365일 이전 데이터까지만 가능합니다.

이벤트 데이터 추출 기간은 최대 31일입니다.
{% endhint %}

## **쿼리 파라미터** <a href="#query-parameters" id="query-parameters"></a>

<table><thead><tr><th width="210">이름</th><th>필수값 여부<select><option value="xBw0HvmJduZN" label="선택" color="blue"></option><option value="VBuJ6ubzjfbi" label="필수" color="blue"></option></select></th><th>타입</th><th>설명</th></tr></thead><tbody><tr><td><code>service_id</code></td><td><span data-option="VBuJ6ubzjfbi">필수</span></td><td>String</td><td>서비스 ID</td></tr></tbody></table>

## **헤더** <a href="#headers" id="headers"></a>

<table><thead><tr><th>필드명</th><th>필수값 여부<select><option value="3Gw9yCGdnldk" label="필수" color="blue"></option><option value="mVPQehiUZOei" label="선택" color="blue"></option></select></th><th>타입</th><th>값</th><th>설명</th></tr></thead><tbody><tr><td><code>Content-Type</code></td><td><span data-option="3Gw9yCGdnldk">필수</span></td><td>String</td><td><code>application/json</code></td><td>-</td></tr><tr><td><code>Authorization</code></td><td><span data-option="3Gw9yCGdnldk">필수</span></td><td>String</td><td><code>Bearer your-auth-token</code></td><td>API 인증 토큰</td></tr></tbody></table>

## **요청 본문** <a href="#request-body" id="request-body"></a>

<table><thead><tr><th>필드명</th><th>필수값 여부<select><option value="xBw0HvmJduZN" label="선택" color="blue"></option><option value="VBuJ6ubzjfbi" label="필수" color="blue"></option></select></th><th>타입</th><th>설명</th></tr></thead><tbody><tr><td><code>campaign_id</code></td><td><span data-option="VBuJ6ubzjfbi">필수</span></td><td>String</td><td>캠페인 ID</td></tr><tr><td><code>campaign_type</code></td><td><span data-option="VBuJ6ubzjfbi">필수</span></td><td>String</td><td><p>캠페인 유형, 아래 값을 지원합니다.</p><p><code>OS_PUSH</code> : OS 푸시,</p><p><code>AD_PUSH</code> : 광고 푸시,</p><p><code>TEXT_MESSAGE</code> : 문자,</p><p><code>KAKAO_ALIMTALK</code> : 카카오 알림톡,</p><p><code>KAKAO_BRAND_MESSAGE</code> : 카카오 브랜드 메시지,</p><p><code>IN_APP_MESSAGE</code> : 인앱 메시지,</p><p><code>JOURNEY</code> : 캠페인 여정</p></td></tr><tr><td><code>report_type</code></td><td><span data-option="VBuJ6ubzjfbi">필수</span></td><td>String</td><td><p>캠페인 리포트 타입, 아래 값을 지원합니다.</p><p><code>COMPLETION</code> : 성공/실패,</p><p><code>CLICK</code> : 클릭,</p><p><code>CONVERSION</code> : 구매 및 전환</p></td></tr><tr><td><code>from_date</code></td><td><span data-option="VBuJ6ubzjfbi">필수</span></td><td>Date</td><td>이벤트 조회 시작일(<code>yyyy-MM-dd),</code><br>추출기간은 다음과 같습니다. <code>from_date</code>의 00시 00분 &#x3C;= 추출기간 &#x3C; <code>to_date</code> 의 00시 00분</td></tr><tr><td><code>to_date</code></td><td><span data-option="xBw0HvmJduZN">선택</span></td><td>Date</td><td>이벤트 조회 종료일(<code>yyyy-MM-dd),</code>추출기간은 다음과 같습니다. <code>from_date</code>의 00시 00분 &#x3C;= 추출기간 &#x3C; <code>to_date</code> 의 00시 00분, <code>to_date</code> 를 입력하지 않을 시 <code>to_date</code>는 현재 시간이 됩니다.</td></tr></tbody></table>

## **응답** <a href="#response" id="response"></a>

리포트 추출의 응답은 `,` 로 구분되는 헤더가 포함된 csv 포맷입니다. 첫번째 줄이 헤더이고, 두번째 줄부터 추출된 데이터입니다. 아래의 표는 주요 헤더에 대한 설명입니다.

값이 존재하지 않을 경우 기본값은 빈 값(empty) 입니다.

아래는 캠페인 유형별 응답 상세입니다.

#### 단건 캠페인 응답 상세 <a href="#single-campaign-response" id="single-campaign-response"></a>

<table><thead><tr><th>필드명</th><th>타입</th><th>설명</th><th>COMPLETION<select><option value="ytNcilfpsRx3" label="지원" color="blue"></option><option value="zUZKtUNWQQRi" label="미지원" color="blue"></option></select></th><th>CLICK<select><option value="aTdSxoav6pxA" label="미지원" color="blue"></option><option value="ZX4pvmMfExjv" label="지원" color="blue"></option></select></th><th>CONVERSION<select><option value="gaeJjX74VONw" label="지원" color="blue"></option><option value="9leL4roASeU0" label="미지원" color="blue"></option></select></th></tr></thead><tbody><tr><td><code>report_datetime</code></td><td>Datetime</td><td>리포트 시</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="ZX4pvmMfExjv">지원</span></td><td><span data-option="gaeJjX74VONw">지원</span></td></tr><tr><td><code>campaign_id</code></td><td>String</td><td>캠페인 ID</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="ZX4pvmMfExjv">지원</span></td><td><span data-option="gaeJjX74VONw">지원</span></td></tr><tr><td><code>campaign_name</code></td><td>String</td><td>캠페인 이름</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="ZX4pvmMfExjv">지원</span></td><td><span data-option="gaeJjX74VONw">지원</span></td></tr><tr><td><code>campaign_status</code></td><td>String</td><td>캠페인 상태</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="ZX4pvmMfExjv">지원</span></td><td><span data-option="gaeJjX74VONw">지원</span></td></tr><tr><td><code>df_external_id</code></td><td>String</td><td>외부 ID</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="ZX4pvmMfExjv">지원</span></td><td><span data-option="gaeJjX74VONw">지원</span></td></tr><tr><td><code>is_success</code></td><td>Boolean</td><td>발송/처리 성공 여부</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="aTdSxoav6pxA">미지원</span></td><td><span data-option="9leL4roASeU0">미지원</span></td></tr><tr><td><code>result_message</code></td><td>String</td><td>발송/처리 결과 메시지</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="aTdSxoav6pxA">미지원</span></td><td><span data-option="9leL4roASeU0">미지원</span></td></tr><tr><td><code>click</code></td><td>Long</td><td>클릭</td><td><span data-option="zUZKtUNWQQRi">미지원</span></td><td><span data-option="ZX4pvmMfExjv">지원</span></td><td><span data-option="9leL4roASeU0">미지원</span></td></tr><tr><td><code>purchase_count</code></td><td>Long</td><td>구매 전환 수</td><td><span data-option="zUZKtUNWQQRi">미지원</span></td><td><span data-option="aTdSxoav6pxA">미지원</span></td><td><span data-option="gaeJjX74VONw">지원</span></td></tr><tr><td><code>purchase_amount</code></td><td>Double</td><td>구매 전환 금</td><td><span data-option="zUZKtUNWQQRi">미지원</span></td><td><span data-option="aTdSxoav6pxA">미지원</span></td><td><span data-option="gaeJjX74VONw">지원</span></td></tr></tbody></table>

#### 캠페인 여정 응답 상세 <a href="#journey-campaign-response" id="journey-campaign-response"></a>

<table><thead><tr><th>필드명</th><th>타입</th><th>설명</th><th>COMPLETION<select><option value="ytNcilfpsRx3" label="지원" color="blue"></option><option value="nU3M0EPamO2T" label="미지원" color="blue"></option></select></th><th>CLICK<select><option value="aTdSxoav6pxA" label="미지원" color="blue"></option><option value="WKquGYDjq5vY" label="지원" color="blue"></option></select></th><th>CONVERSION<select><option value="hfuDCttfN6Nd" label="미지원" color="blue"></option><option value="RRVKXxosyVO2" label="지원" color="blue"></option></select></th></tr></thead><tbody><tr><td><code>report_datetime</code></td><td>Datetime</td><td>리포트 시</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="WKquGYDjq5vY">지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr><tr><td><code>journey_id</code></td><td>String</td><td>캠페인 여정 ID</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="WKquGYDjq5vY">지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr><tr><td><code>journey_name</code></td><td>String</td><td>캠페인 여정 이름</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="WKquGYDjq5vY">지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr><tr><td><code>journey_status</code></td><td>String</td><td>캠페인 여정 상태</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="WKquGYDjq5vY">지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr><tr><td><code>node_id</code></td><td>String</td><td>캠페인 여정 노드 ID</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="WKquGYDjq5vY">지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr><tr><td><code>node_name</code></td><td>String</td><td>캠페인 여정 노드 이름</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="WKquGYDjq5vY">지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr><tr><td><code>node_type</code></td><td>String</td><td>캠페인 여정 노드 타입</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="WKquGYDjq5vY">지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr><tr><td><code>df_external_id</code></td><td>String</td><td>외부 ID</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="WKquGYDjq5vY">지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr><tr><td><code>is_success</code></td><td>Boolean</td><td>발송/처리 성공 여부</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="aTdSxoav6pxA">미지원</span></td><td><span data-option="hfuDCttfN6Nd">미지원</span></td></tr><tr><td><code>result_message</code></td><td>String</td><td>발송/처리 결과 메시지</td><td><span data-option="ytNcilfpsRx3">지원</span></td><td><span data-option="aTdSxoav6pxA">미지원</span></td><td><span data-option="hfuDCttfN6Nd">미지원</span></td></tr><tr><td><code>click</code></td><td>Long</td><td>클릭</td><td><span data-option="nU3M0EPamO2T">미지원</span></td><td><span data-option="WKquGYDjq5vY">지원</span></td><td><span data-option="hfuDCttfN6Nd">미지원</span></td></tr><tr><td><code>purchase_count</code></td><td>Long</td><td>구매 전환 수</td><td><span data-option="nU3M0EPamO2T">미지원</span></td><td><span data-option="aTdSxoav6pxA">미지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr><tr><td><code>purchase_amount</code></td><td>Double</td><td>구매 전환 금액</td><td><span data-option="nU3M0EPamO2T">미지원</span></td><td><span data-option="aTdSxoav6pxA">미지원</span></td><td><span data-option="RRVKXxosyVO2">지원</span></td></tr></tbody></table>

## 요청 예시 <a href="#request-example" id="request-example"></a>

```sh
curl -L \
  -X POST \
  -H 'Authorization: Bearer ${your-export-api-token}' \
  -H 'Content-Type: application/json' \
  'https://openapi.dfinery.ai/api/v1/export/report?service_id=${your-service-id}' \
  -d '{
    "campaign_id": "dfinery",
    "campaign_type": "JOURNEY",
    "report_type": "CONVERSION",
    "from_date": "2026-05-01",
    "to_date": "2026-05-31"
}' -o results.csv
```

## 응답 예시 <a href="#response-example" id="response-example"></a>

### 성공 응답 <a href="#success-response" id="success-response"></a>

<pre><code><strong>200 OK
</strong>
report_datetime,journey_id,journey_name,journey_status,node_id,node_type,df_external_id,purchase_count,purchase_amount
2026-05-02 16:49:41.396762,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,40690
2026-05-09 10:01:05.790648,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,90730
2026-05-11 14:17:06.637286,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,23460
2026-05-11 16:44:44.146596,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,45700
2026-05-12 11:43:38.148500,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,54320
2026-05-13 06:35:08.849697,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,23520
2026-05-17 19:20:48.117039,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,55530
2026-05-18 11:06:27.511948,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,40400
2026-05-21 09:10:11.809824,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,40480
2026-05-21 09:51:45.988206,dfinery,시나리오,Active,tmdfinery,TEXT_MESSAGE,external_id,1,15400
</code></pre>

### 실패 응답 <a href="#error-response" id="error-response"></a>

자세한 내용은 [상세 응답](/api-guide/api/export-api/response.md) 참고하시면 됩니다.