# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://adpopcornssp.gitbook.io/ssp-sdk/undefined-2/api/popcontent-report-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.