Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Epidemic Sound Safelisting API

Endpoints for managing safelisting licenses. Allows partners to create, list, update, and delete licenses for channels and videos on behalf of their end users.

Epidemic Sound Safelisting API is one of 9 APIs that Epidemic Sound publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Safelisting. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 2 paths, and defines 8 schemas. It is described by OpenAPI 3.0.1, at version 0.1.17.

Requests are made against a single base URL, https://partner-content-api.epidemicsound.com.

6 operations 2 paths 8 schemas 2 DELETE2 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
0.1.17
Base URL
https://partner-content-api.epidemicsound.com
Authentication
HTTP Bearer, HTTP Bearer, HTTP Bearer, OAuth 2.0
Resource Areas
1

Authentication & Security 4

Epidemic Sound Safelisting API declares 4 security schemes for authenticating requests. It accepts HTTP bearer tokens (ApiKeyAuth). It accepts HTTP bearer tokens (PartnerAuth). It accepts HTTP bearer tokens (UserAuth). It supports OAuth 2.0 (EpidemicSoundConnectAuth) using the authorizationCode flow.

  • ApiKeyAuth — API key authentication for server-to-server communication. Pass your API key as a Bearer token in the Authorization header. API keys are prefixed with epidemic…
  • PartnerAuth — Partner authentication is handled with short lived partner access tokens. Use your api credentials to request these tokens. The access token is of JWT format a…
  • UserAuth — 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 b…
  • EpidemicSoundConnectAuth — For users signing in with an Epidemic Sound account, user authentication is handled with OpenID Connect, which is a layer on top of OAuth 2.0. Example Header:…

Paths & Operations 6

Across 2 paths, the API surfaces 6 operations — 2 DELETE, 2 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Safelisting 6

Endpoints for managing safelisting licenses. Allows partners to create, list, update, and delete licenses for channels and videos on behalf of their end users.

GET
/v0/safelisting/licenses
List safelisting licenses
GET_Safelisting_Licenses 8 params → 200400401429
POST
/v0/safelisting/licenses
Create a safelisting license
POST_Safelisting_License 1 param body → 201400401429409403
DELETE
/v0/safelisting/licenses
Delete all licenses for an end user
DELETE_Safelisting_Licenses 1 param → 204401429
GET
/v0/safelisting/licenses/{licenseId}
Get a safelisting license
GET_Safelisting_License 2 params → 200401429404
DELETE
/v0/safelisting/licenses/{licenseId}
Delete a safelisting license
DELETE_Safelisting_License 2 params → 204401429404
PATCH
/v0/safelisting/licenses/{licenseId}
Update a safelisting license
PATCH_Safelisting_License 2 params body → 200400401429404

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are SafelistingLicenseResponse (4 properties), SafelistingAssetResponse (4 properties), SafelistingLicenseListResponse (4 properties), SafelistingAssetRequest (3 properties). Each schema is shown below with its type and property counts.

SafelistingAssetRequest
object
3 properties 3 required
SafelistingLicenseListResponse
object
4 properties 4 required
Error
object
2 properties 2 required
MessageResponse
object
2 properties 1 required
UpdateSafelistingLicenseRequest
object
1 property 1 required
CreateSafelistingLicenseRequest
object
2 properties 1 required
SafelistingAssetResponse
object
4 properties 4 required
SafelistingLicenseResponse
object
4 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

epidemic-sound-safelisting-api-openapi.yml Raw ↑

Other APIs Epidemic Sound publishes across the network.

Epidemic Sound Assets API
Epidemic Sound Authentication API
Epidemic Sound Beta API
Epidemic Sound Browse & search API
Epidemic Sound Reporting API
Epidemic Sound Sound effects API
Epidemic Sound Tracks API
Epidemic Sound Users API