Popcontent Report API

매일 오전 11시 50분에 2일 전 데이터가 확정됩니다.

URL

• https://sspi-ext-report.adpopcorn.com/v1/analytics/data

Method

• GET

Request Headers

Name	Type	Value	필수	설명
Authorization	string	Bearer ${access_token}	Y	생성된 액세스 토큰을 ${access_token} 자리에 넣어 인증에 사용하세요.

$ curl "https://sspi-ext-report.adpopcorn.com/v1/analytics/data?fromDate=20220101&toDate=20220101" -H "Authorization: Bearer test_access_token" -L

Query Parameter

Parameter	Type	필수	설명
fromDate	string	Y	시작일 (yyyyMMdd or yyyy-MM-dd)
toDate	string	Y	종료일 (yyyyMMdd or yyyy-MM-dd)

Content-Type

• application/json

Response Body

Body parameter	Type	설명
alert	string	서버에서 전송된 알림 메시지. 대부분의 경우 null일 것입니다. 예시: "alert": null
records	Array of object	리포트 데이터

ID	Type	설명
report_date	string	날짜 (yyyyMMdd)
channel_id	string	채널 ID
service_id	string	서비스 ID
page_id	numeric	서비스 페이지 ID
os_type	numeric	1: 안드로이드, 2: iOS
ssp_placement_id	string	SSP 지면 ID
impression	numeric	노출수
click	numeric	클릭수
media_cost	numeric	revenue (USD)

200

{
    "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
        }
    ]
}

HTTP Status Code

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

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