ニコニ広告API
ニコニ広告対応サービス
| サービス | {Service} | {ContentId}例 |
|---|---|---|
| 動画 | video | sm9 |
| 生放送 | live | lv322786567 |
| アツマール | atsumaru | gm9482 |
| 大百科 | nicodic | 1314224 |
貢献度ランキング
https://api.nicoad.nicovideo.jp/v1/contents/{Service}/{ContentId}/ranking/contribution?limit=10
- {Service}
- 動画=video、生放送=live、アツマール=atsumaru、大百科=nicodic、超タグ1GP=tag1
- {ContentId}
- 動画「sm9」、生放送「lv322786567」、アツマール「gm9482」、大百科「1314224」、超タグ1GP「mmd2020」
レスポンス例
https://api.nicoad.nicovideo.jp/v1/contents/video/sm9/ranking/contribution?limit=3
{ "meta": { "status": 200 }, "data": { "contentId": "sm9", "contentType": "video", "contentTotalContribution": 10207732, "count": 3, "ranking": [{ "userId": 60505909, "advertiserName": "マイケル", "totalContribution": 1780769, "rank": 1, "userPageUrl": "https://www.nicovideo.jp/user/60505909" }, { "userId": 63364878, "advertiserName": "魔剣士ムスカ", "totalContribution": 1096391, "rank": 2, "userPageUrl": "https://www.nicovideo.jp/user/63364878" }, { "userId": 5428353, "advertiserName": "○●丸", "totalContribution": 1002248, "rank": 3, "userPageUrl": "https://www.nicovideo.jp/user/5428353" }] } }
広告履歴
https://api.nicoad.nicovideo.jp/v1/contents/{Service}/{ContentId}/histories?limit=10&offset=10
- {Service}
- 動画=video、生放送=live、アツマール=atsumaru、大百科=nicodic、超タグ1GP=tag1
- {ContentId}
- 動画「sm9」、生放送「lv322786567」、アツマール「gm9482」、大百科「1314224」、超タグ1GP「mmd2020」
レスポンス例
https://api.nicoad.nicovideo.jp/v1/contents/video/sm9/histories?&limit=3
{ "meta": { "status": 200 }, "data": { "count": 7233, "serverTime": 1578399197, "histories": [{ "advertiserName": "深海", "nicoadId": 56398742, "adPoint": 300, "contribution": 301, "startedAt": 1578386161, "endedAt": 1578990961, "userId": 36715409 }, { "advertiserName": "深海", "nicoadId": 56398712, "adPoint": 300, "contribution": 300, "startedAt": 1578386139, "endedAt": 1578990939, "userId": 36715409 }, { "advertiserName": "深海", "nicoadId": 56398693, "adPoint": 300, "contribution": 302, "startedAt": 1578386122, "endedAt": 1578990922, "userId": 36715409 }] } }
貢献成績
https://api.nicoad.nicovideo.jp/v1/users/{UserId}/rewards?limit=10&offset=10
- {UserId}
- ユーザーID
レスポンス例
https://api.nicoad.nicovideo.jp/v1/users/60505909/rewards?limit=3
{ "meta": { "status": 200 }, "data": { "rewards": [{ "rewardId": "4", "rewardType": "owner", "rewardRank": 1, "rewardContribution": 1780769, "rewardTotalContribution": 10234310, "name": "中の", "thumbnailUrl": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/0/4.jpg?1271141672", "nonSchemeThumbnail": "//secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/0/4.jpg?1271141672", "targetUrl": "https://www.nicovideo.jp/user/4" }, { "rewardId": "sm9", "rewardType": "video", "rewardRank": 1, "rewardContribution": 1780769, "rewardTotalContribution": 10207754, "name": "新・豪血寺一族 -煩悩解放 - レッツゴー！陰陽師", "thumbnailUrl": "https://nicovideo.cdn.nimg.jp/thumbnails/9/9", "nonSchemeThumbnail": "//nicovideo.cdn.nimg.jp/thumbnails/9/9", "targetUrl": "https://www.nicovideo.jp/watch/sm9" }, { "rewardId": "28008453", "rewardType": "owner", "rewardRank": 1, "rewardContribution": 0, "rewardTotalContribution": 0, "name": "kentaurus", "thumbnailUrl": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/defaults/blank.jpg", "nonSchemeThumbnail": "//secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/defaults/blank.jpg", "targetUrl": "https://www.nicovideo.jp/user/28008453" }], "count": 4 } }
広告結果
https://api.nicoad.nicovideo.jp/v1/nicoad/{nicoadId}/result
- {nicoadId}
- ニコニ広告ID
レスポンス例
https://api.nicoad.nicovideo.jp/v1/nicoad/56398742/result
{ "meta": { "status": 200 }, "data": { "id": 56398742, "listOfContentCountSnapped": [{ "id": 146579761, "contentId": "sm9", "contentType": "video", "count": 18558629, "snappedType": 1, "createdAt": 1578386161 }, { "id": 0, "contentId": "sm9", "contentType": "video", "count": 0, "snappedType": 3, "createdAt": 1578409200 }, { "id": 0, "contentId": "sm9", "contentType": "video", "count": 0, "snappedType": 3, "createdAt": 1578495600 }, { "id": 0, "contentId": "sm9", "contentType": "video", "count": 0, "snappedType": 3, "createdAt": 1578582000 }, { "id": 0, "contentId": "sm9", "contentType": "video", "count": 0, "snappedType": 3, "createdAt": 1578668400 }, { "id": 0, "contentId": "sm9", "contentType": "video", "count": 0, "snappedType": 3, "createdAt": 1578754800 }, { "id": 0, "contentId": "sm9", "contentType": "video", "count": 0, "snappedType": 3, "createdAt": 1578841200 }, { "id": 0, "contentId": "sm9", "contentType": "video", "count": 0, "snappedType": 3, "createdAt": 1578927600 }, { "id": 0, "contentId": "sm9", "contentType": "video", "count": 0, "snappedType": 2, "createdAt": 1578990961 }], "impressionPerFrame": [{ "id": 12, "name": "ニコニコ動画視聴ページ枠（PC）", "impression": 1, "grade": 2 }] } }
