> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Raw Data 추출 요청하기

에어브릿지로 트래킹한 광고 성과의 로우 데이터(Raw Data)는 에어브릿지 대시보드 \[Raw Data] 메뉴에서 CSV 파일로 다운로드할 수 있습니다. 로우 데이터는 에어브릿지 대시보드 \[App Raw Data]와 \[Web Raw Data]에서 확인할 수 있습니다.

Raw Data 추출을 요청합니다.

rate limit : 하루 100개로 제한됩니다.

<Card title="Try API Request" icon="rectangle-api" horizontal href="https://www.postman.com/airbridge-engineering/workspace/airbridge-api/request/22395869-0cdb8bc7-2677-4f41-8e1b-4529081ed524" />

```text POST theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
https://api.airbridge.io/log-export/api/v3/apps/{app_name}/{type}/request
```

<h2 id="raw-data-추출-요청하기-request">
  Request
</h2>

***

<h3 id="raw-data-추출-요청하기-body-params">
  Body Params
</h3>

<ParamField body="dateRange" type="object" required>
  데이터 추출 기간을 설정합니다.

  <Expandable title="하위 변수">
    <ParamField body="dateRange.start" type="string" required>
      요청할 리포트 데이터의 시작일.

      * `YYYY-MM-DD HH:mm:ss` 형태입니다.
      * 에어브릿지 앱의 타임존이 적용된 날짜이어야 합니다.
      * 현재로부터 179일 전까지 설정할 수 있습니다.
    </ParamField>

    <ParamField body="dateRange.end" type="string" required>
      요청할 리포트 데이터의 종료일.

      * `YYYY-MM-DD HH:mm:ss` 형태입니다.
      * 에어브릿지 앱의 타임존이 적용된 날짜이어야 합니다.
      * 현재 날짜까지 설정할 수 있으며 최대 조회 기간은 31일입니다.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="events" type="string[]" required>
  추출하고자 하는 이벤트. Event ([App Event Key](https://docs.google.com/spreadsheets/d/13ThNnryqRmZQwJVecM8lZ2OB7LzA8s3cwLlQBGpbXLg/edit#gid=959785444\&range=B:B), [Web Event Key](https://docs.google.com/spreadsheets/d/13ThNnryqRmZQwJVecM8lZ2OB7LzA8s3cwLlQBGpbXLg/edit#gid=1272078068\&range=B:B))
</ParamField>

<ParamField body="properties" type="string[]" required>
  포함할 Property. ([App Event Properties](https://docs.google.com/spreadsheets/d/13ThNnryqRmZQwJVecM8lZ2OB7LzA8s3cwLlQBGpbXLg/edit#gid=723627948\&range=B:B), [Web Event Properties](https://docs.google.com/spreadsheets/d/13ThNnryqRmZQwJVecM8lZ2OB7LzA8s3cwLlQBGpbXLg/edit#gid=253177103\&range=B:B))
</ParamField>

<ParamField body="filters" type="object[]">
  'Properties'로 제공하는 항목들에 대한 필터.

  조건을 만족하는 데이터에 대한 통계 데이터를 리포트에서 조회할 수 있습니다.

  <Expandable title="하위 변수">
    <ParamField body="filters[0].field" type="string">
      필터를 지정할 Property 필드.
    </ParamField>

    <ParamField body="filters[0].condition" type="object">
      <Expandable title="하위 변수">
        <ParamField body="filters[0].condition.type" type="enum" required>
          필터에 적용할 연산자.

          | 벨류          | 설명           |
          | ----------- | ------------ |
          | `equal`     | 같다.          |
          | `not_equal` | 같지 않다.       |
          | `in`        | 속해있다.        |
          | `not_in`    | 속해있지 않다.     |
          | `exist`     | 값이 존재한다.     |
          | `not_exist` | 값이 존재하지 않는다. |
          | `lt`        | 작다.          |
          | `lte`       | 작거나 같다.      |
          | `gt`        | 크다.          |
          | `gte`       | 크거나 같다.      |
          | `between`   | 사이에 있다.      |
        </ParamField>

        <ParamField body="filters[0].condition.value" type="string" required>
          필터에 적용할 값. 타입이 "equal", "not\_equal", "lt", "lte", "gt", "gte" 일 때 사용합니다.
        </ParamField>

        <ParamField body="filters[0].condition.values" type="string[]" required>
          필터에 적용할 값. 타입이 "in", "not\_in"일 경우 사용합니다.
        </ParamField>

        <ParamField body="filters[0].condition.start" type="string" required>
          타입이 between일 경우 시작일.
        </ParamField>

        <ParamField body="filters[0].condition.end" type="string" required>
          타입이 between일 경우 종료일.
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```shellscript Request theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  curl -X POST 'https://api.airbridge.io/log-export/api/v3/apps/{app_name}/{type}/request' \
    -d '{
    "dateRange": {
      "start": "2023-01-01 01:00:00",
      "end": "2023-01-07 01:00:00"
    },
    "events": [
      "app_install"
    ],
    "properties": [
      "channel"
    ]
  }'
  ```
</RequestExample>

<h2 id="raw-data-추출-요청하기-response">
  Response
</h2>

***

### 200

### 404

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "at": 1541410684717,
    "data": {
      "reportID": 2500
    }
  }
  ```

  ```json 404 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "type": "about:blank",
    "title": "Not Found",
    "status": 404,
    "traceId": "1-000000-000000000000000"
  }
  ```
</ResponseExample>