Skip to main content

Report usage

Report track usage to Epidemic Sound when users export their content to social media platforms or download content files to their device. This data is used for billing & analytics-purposes.

Music tracks only

Usage reporting is music-only. Both reporting endpoints validate track IDs against the music catalog and return 404 for sound effect IDs.

When to report usage​

Report usage when:

  • User exports their content to a social media platform
  • User downloads the complete video+music composition to their device (use platform "local")

Do not report usage for:

  • Preview playback during browsing
  • Your application is downloading tracks (such as music used in a video editor)

Per-user reporting​

Use the usage endpoint for individual usage events. The x-partner-user-id header identifies which end user is using the track for per-user analytics and billing attribution:

POST /v0/usage
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY
x-partner-user-id: user123

{
  "trackId": "1a8d1f60-398c-3cec-83bf-4ed5efd3b851",
  "platform": "YOUTUBE"
}

Supported platforms:

  • YOUTUBE
  • TWITTER
  • TWITCH
  • FACEBOOK
  • INSTAGRAM
  • TIKTOK
  • OTHER
  • LOCAL (for downloads to device)

Rate limiting: Usage reporting does not count against the per-user weekly rate limits - only audio delivery endpoints (download, stream, HLS) count toward those limits.

Bulk reporting​

Use the bulk reporting endpoint for batch processing:

POST /v0/analytics/report
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "events": [
    {
      "userId": "user123",
      "trackId": "1a8d1f60-398c-3cec-83bf-4ed5efd3b851",
      "platform": "YOUTUBE"
    },
    {
      "userId": "user456",
      "trackId": "2b9e2g71-499d-4dfd-94cg-5fe6gge4c962",
      "platform": "TIKTOK"
    }
  ]
}

Batch limits: Up to 100 events per request.

Backend authentication required for bulk reporting

The bulk reporting endpoint must be called from your backend using your API key. For client-side per-user reporting, use the /v0/usage endpoint with the x-partner-user-id header.