Searches tracks by ID, Title, or Artist fields.

get https://developers.emysound.com/api/v1.1/Tracks

Provides fuzzy search for Title or Artist fields. ID field should be provided as an exact match.

Empty q will return all tracks.

Array of trackIds will limit the search space to the provided IDs.

Query Params

string

Query string to search for (default empty).

offset

int32

Defaults to 0

Offset used for pagination.

limit

int32

Defaults to 50

Limit used for pagination.

facets

array of strings

Facets to return. Supported facets: metaFields.*.

facets

facetValuesLimit

array of strings

Maximum values to return per facet, encoded in the format facetName:limit.

Default value is 2048.

facetValuesLimit

filters

array of strings

Limit search space by filtering only through the provided list of filter values.

Example 1: filters=id:1&filters=id:2 - will return only tracks with ids equal to 1 or 2.

Example 2: filters=metaFields.product:iPhone - will return only tracks that contain product:iPhone key-value pair in the tracks metaFields.

Example 3: filters=!metaFields.product:iPhone - will return all tracks that do not contain product:iPhone key-value pair in the tracks metaFields.

filters

intervalFilters

array of strings

Interval filters, supplied as low (inclusive) and high (exclusive) range values. Filter values referring to dates are measured in Unix Epoch seconds.

Supported interval filters: insertDate, audioTrackLength, videoTrackLength.

Example 1: intervalFilters=insertDate:[1640995200,1641081600], will return tracks that have been inserted between January 1, 2022 00:00:00 - January 1, 2022 23:59:59 dates.

Example 2: intervalFilters=audioTrackLength:[0,600], will return tracks those length does not exceed 600 seconds.

intervalFilters

cursor

string

Cursor used in paginating, when "" is provided the first page of the results will be returned. You can use either offset, or cursor to paginate the results.

Cursor is a better option when you want to obtain a snapshot-in-time list of tracks, which is not affected by newly inserted entities.

Responses

500

Something went wrong. Contact support.

Language

Credentials

Basic

base64

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://developers.emysound.com/api/v1.1/Tracks?offset=0&limit=50' \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200JSON containing TrackInfos object.

401Request not authorized.