基础信息

文档版本：V1.0.3

接口地址：http://apidata.mediaprime.top/api/open/report

**请求方式：**http post

**返回类型：**json

**接口描述：**查询T+1的展点消数据

请求限制：每秒请求一次

请求体格式：form-data

更新记录

v.1.0.3

1. 新增「注意事项」章节，用于提示用户在拉取数据时需要重点关注的内容，确保数据使用更加准确与规范。

v.1.0.2

1. 新增请求参数 isTest 用于区分拉取测试或正式广告位数据：

   • true：仅拉取测试广告位数据

   • false：仅拉取正式广告位数据

   • 默认值为空：拉取全部广告位数据

2. 新增返回字段 slotIsTest 表示该广告位是否为测试广告位，类型为 int。

3. 废弃返回字段 impUv 该字段已不再返回，请相关方尽快调整依赖逻辑。

注意事项

1. token和accountId请在登录系统后查阅接入中心。
2. 建议每天中午12点和下午5点，拉取前三天数据，拉到的数据均做覆盖处理，以防存在数据重导的情况。如遇超过前三天的数据存在重导，运营将会在对接群中通知，或请留意系统通知。

请求Header

名称	必填	类型	说明
token	是	string	token

请求参数

名称	必填	类型	说明
startDate	是	string	开始时间
endDate	是	string	结束时间
accountId	是	int	账户ID
mediaId	否	int	媒体ID
slotId	否	int	广告位ID
page	否	int	当前页数，默认值为1
size	否	int	每页返回条数, 默认50 , 最大200
isTest	否	Boolean	true：仅拉取测试广告位数据；false：仅拉取正式广告位数据；默认值为空：拉取全部广告位数据

返回参数说明

名称	类型	说明
code	int	返回码，0表示正常
msg	string	返回说明
data	json	返回数据
rows	array	数据明细
date	string	日期
page	int	当前页
size	int	当前页返回条数
total	int	当前查询条件下的总数据量
accountId	int	账户ID
accountName	string	账户名称
mediaId	int	媒体ID
mediaName	string	媒体名称
slotId	int	广告位ID
slotName	string	广告位名称
slotIsTest	int	是否是测试广告位（0:正式，1:测试）
slotType	int	广告位类型(1: 视频贴片, 2:视频暂停, 3:浮层, 4:banner, 5:开屏 , 6:插屏,7:信息流, 8:文字链, 9:动态创意, 10:激励视频, 11:Draw信息流, 12:互动广告,13:个性模板广告)
impPv	int	展现量
impUv	int	广告位级别的展现UV（废弃）
clickPv	int	点击量
revenue	float	预估收入，单位元
bidPv	Long	请求量

curl请求示例

curl --location --request POST 'http://apidata.mediaprime.top/api/open/report' \
--header 'token: xxxxxxxxxxxxxxxxxx' \
--form 'startDate="2025-03-20"' \
--form 'endDate="2025-03-22"' \
--form 'accountId=0' \
--form 'mediaId=0' \
--form 'slotId=0' \
--form 'page=1' \
--form 'size=50'

Json返回示例

{
    "code": 0,
    "msg": "SUCCESS",
    "data": {
        "rows": [
            {
                "date": "2025-03-20",
                "accountId": 0,
                "accountName": "公司名称",
                "mediaId": 0,
                "mediaName": "媒体名称",
                "slotId": 0,
                "slotName": "广告位名称",
                "slotType": 7,
                "slotIsTest": 1,
                "impPv": 10000,
                "clickPv": 10000,
                "revenue": 99.99,
                "bidPv": 10000
            },
            {
                "date": "2025-03-21",
                "accountId": 0,
                "accountName": "公司名称",
                "mediaId": 0,
                "mediaName": "媒体名称",
                "slotId": 0,
                "slotName": "广告位名称",
                "slotType": 7,
                "slotIsTest": 1,
                "impPv": 10000,
                "clickPv": 10000,
                "revenue": 99.99,
                "bidPv": 10000
            },
            {
                "date": "2025-03-22",
                "accountId": 0,
                "accountName": "公司名称",
                "mediaId": 0,
                "mediaName": "媒体名称",
                "slotId": 0,
                "slotName": "广告位名称",
                "slotType": 7,
                "slotIsTest": 1,
                "impPv": 10000,
                "clickPv": 10000,
                "revenue": 99.99,
                "bidPv": 10000
            },
        ],
        "page": 1,
        "size": 3,
        "total": 3
    }
}=