Report usage

POST 
https://partner-content-api.epidemicsound.com/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

application/json

Body

Usage report

eventType string

Possible values: [EXPORTED]

platform stringrequired

Possible values: [YOUTUBE, TWITTER, TWITCH, FACEBOOK, INSTAGRAM, TIKTOK, OTHER, LOCAL]

trackIds string[]required
other stringnullable

Responses

200

Usage report response

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Ok"
}

400

Bad request.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Bad request"
}

401

Unauthorized. Most likely your access token has expired.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Invalid credentials"
}

429

Rate limit exceeded.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Rate limit exceeded"
}

Authorization: http

name: UserAuthtype: httpdescription: User authentication is handled with short lived user access tokens.
 Use a partner token to request these tokens.
 The access token is of JWT format and should be passed in a header with your API requests:
 
 > **Example Header:** `Authorization: Bearer a-user-token`scheme: bearer

• curl
• python
• nodejs

• CURL

curl -L 'https://partner-content-api.epidemicsound.com/v0/usage' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "eventType": "EXPORTED",
  "platform": "YOUTUBE",
  "trackIds": [
    "string"
  ],
  "other": "string"
}'

Request Collapse all

Base URL

https://partner-content-api.epidemicsound.com

Auth

Security Scheme

UserAuthEpidemicSoundConnectAuth

Bearer Token

Body

• Example (from schema)
• Example

{
  "eventType": "EXPORTED",
  "platform": "YOUTUBE",
  "trackIds": [
    "string"
  ],
  "other": "string"
}

ResponseClear

Click the Send API Request button above and see the response here!