Search tracks suggestions

GET 
https://partner-content-api.epidemicsound.com/v0/tracks/search/suggestions

The search suggestions endpoint allows your users to get autocomplete suggestions for Epidemic Sound music

Request

Query Parameters

term string

Term for search

Responses

200

Tracks Search Suggestions response

application/json

Schema

Schema

suggestions

object[]

Array [

type string

Possible values: [TEXT]

]

Example (from schema)

{
  "suggestions": [
    {
      "type": "TEXT"
    }
  ]
}

Example

{
  "suggestions": [
    {
      "value": "rock",
      "type": "TEXT"
    },
    {
      "value": "rocker",
      "type": "TEXT"
    },
    {
      "value": "rock n roll",
      "type": "TEXT"
    }
  ]
}

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"
}

403

Forbidden. Only available for ES Connect tokens or User tokens when the app allows to preview tracks.

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": "Forbidden"
}

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"
}

503

Service unavailable

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": "Service unavailable"
}

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

Request Collapse all

Base URL

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

Auth

Security Scheme

UserAuthEpidemicSoundConnectAuth

Bearer Token

Parameters

term — query

ResponseClear

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