---
title: "Report usage"
method: POST
path: "/v0/usage"
tags: ["Reporting"]
---

# Report usage

`POST /v0/usage`

The usage endpoint lets you report when a user exports their content to social media or downloads the content file to their device.
You can specify which platform (YouTube, Twitch, Instagram, Facebook, TikTok, Twitter or Other) they export the file to. Use the platform `local` if the user downloads the content to their device.
This data is used for attribution and analytics purposes as well as to improve personalization.

## Request body

- TrackUsageRequest
  - `eventType` 'EXPORTED'
  - `platform` 'YOUTUBE' | 'TWITTER' | 'TWITCH' | 'FACEBOOK' | 'INSTAGRAM' | 'TIKTOK' | 'OTHER' | 'LOCAL', required
  - `trackIds` string[], required
  - `other` string, nullable

## Response `200`

Usage report response

- MessageResponse
  - `message` string, required — Human readable message
  - `errors` Error[]
    - `key` string, required — Error key
    - `messages` string[], required — Error messages

## Other responses

- `400` — Bad request.
- `401` — Unauthorized. Most likely your access token has expired.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/epidemicsound/apis/partner-content-api.md) · [All operations](https://skmtc.net/epidemicsound/apis/partner-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epidemicsound/partner-content-api/revisions/7a3e05c7cda1/schema)