> For the complete documentation index, see [llms.txt](https://adpopcornssp.gitbook.io/ssp-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adpopcornssp.gitbook.io/ssp-sdk/undefined-2/api/popcontent-report-api.md).

# Popcontent Report API

{% hint style="info" %}
매일 오전 11시 50분에 <mark style="color:orange;">**2일 전**</mark> 데이터가 확정됩니다.
{% endhint %}

## URL

* <https://sspi-ext-report.adpopcorn.com/v1/analytics/data>

## Method

* GET

## Request Headers

<table><thead><tr><th width="154">Name</th><th width="81">Type</th><th width="153">Value</th><th width="69" align="center">필수</th><th>설명</th></tr></thead><tbody><tr><td>Authorization</td><td>string</td><td>Bearer ${access_token}</td><td align="center"><mark style="color:red;">Y</mark></td><td>생성된 액세스 토큰을 ${access_token} 자리에 넣어 인증에 사용하세요.</td></tr></tbody></table>

<pre class="language-bash" data-overflow="wrap" data-full-width="false"><code class="lang-bash"><strong>$ curl "https://sspi-ext-report.adpopcorn.com/v1/analytics/data?fromDate=20220101&#x26;toDate=20220101" -H "Authorization: Bearer test_access_token" -L
</strong></code></pre>

## Query Parameter

<table><thead><tr><th width="156">Parameter</th><th width="95">Type</th><th width="65" align="center">필수</th><th>설명</th></tr></thead><tbody><tr><td>fromDate</td><td>string</td><td align="center"><mark style="color:red;">Y</mark></td><td>시작일 (yyyyMMdd or yyyy-MM-dd)</td></tr><tr><td>toDate</td><td>string</td><td align="center"><mark style="color:red;">Y</mark></td><td>종료일 (yyyyMMdd or yyyy-MM-dd)</td></tr></tbody></table>

## Content-Type

* application/json

## Response Body

<table><thead><tr><th width="188">Body parameter</th><th width="142">Type</th><th>설명</th></tr></thead><tbody><tr><td>alert</td><td>string</td><td>서버에서 전송된 알림 메시지. 대부분의 경우 null일 것입니다. 예시: "alert": null</td></tr><tr><td>records</td><td>Array of object</td><td>리포트 데이터</td></tr></tbody></table>

<table><thead><tr><th width="201">ID</th><th width="130">Type</th><th>설명</th></tr></thead><tbody><tr><td>report_date</td><td>string</td><td>날짜 (yyyyMMdd)</td></tr><tr><td>channel_id</td><td>string</td><td>채널 ID</td></tr><tr><td>service_id</td><td>string</td><td>서비스 ID</td></tr><tr><td>page_id</td><td>numeric</td><td>서비스 페이지 ID</td></tr><tr><td>os_type</td><td>numeric</td><td>1: 안드로이드, 2: iOS</td></tr><tr><td>ssp_placement_id</td><td>string</td><td>SSP 지면 ID</td></tr><tr><td>impression</td><td>numeric</td><td>노출수</td></tr><tr><td>click</td><td>numeric</td><td>클릭수</td></tr><tr><td>media_cost</td><td>numeric</td><td>revenue (USD)</td></tr></tbody></table>

{% tabs %}
{% tab title="200" %}

```json

{
    "alert": null,
    "records": [
        {
            "report_date": "20250111",
            "channel_id": 1,
            "service_id": 10,
            "page_id": "WHOWHO_AI_PICKS",
            "os_type": 2,
            "ssp_placement_id": "sYSy4BI1vPmG3aQ",
            "impression": 3,
            "click": 1,
            "media_cost": 0.00189
        }
    ]
}

```

{% endtab %}
{% endtabs %}

## HTTP Status Code

아래 표는 Adpopcorn API 플랫폼에서 REST API 응답으로 전송되는 일반적인 HTTP 상태 코드를 나열한 것입니다.

<table><thead><tr><th width="126">Code</th><th width="173">메세지</th><th>설명</th></tr></thead><tbody><tr><td>200</td><td>성공</td><td>요청이 성공적으로 처리되었습니다.</td></tr><tr><td>400</td><td>client-side 에러</td><td>유효성 검사에 실패했습니다.</td></tr><tr><td>401</td><td>인증되지 않음</td><td>인증 또는 권한 부여 실패가 발생했습니다.</td></tr><tr><td>500</td><td>API-side 에러</td><td>Adpopcorn API 플랫폼에 문제가 발생했습니다.</td></tr></tbody></table>