Search autosuggest

GET 
/v0/tracks/search/suggestions

The search suggestions endpoint allows your users to get autocomplete suggestions for Epidemic Sound music or external provider music search.

Returns:

• value: The exact search term to pass to the /tracks/search endpoint.
• title: Display text to show users in the autocomplete UI.
• type - Indicates whether this is a search term of type text or external reference URI (e.g., Spotify track).

Usage: When a user selects a suggestion, use the 'value' field as the 'term' parameter when calling /tracks/search to get matching tracks.

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, EXTERNAL_SPOTIFY]

]

Example (from schema)

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

Example

{
  "suggestions": [
    {
      "value": "rock",
      "title": "rock",
      "type": "TEXT"
    },
    {
      "value": "rocker",
      "title": "rocker",
      "type": "TEXT"
    },
    {
      "value": "https://open.spotify.com/track/12345",
      "title": "rocker",
      "type": "EXTERNAL_SPOTIFY"
    }
  ]
}

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

Loading...