Endpoints for retrieving, searching and managing tracks.
Use this endpoint to list tracks.
GET /tracks
Name | Type | Description |
---|---|---|
ids | Array | Array of Track IDs that must be retrieved |
references | Array | Array of Track references that must be retrieved |
page | Integer | Page number (default 1) |
page_size | Integer | Result number per page (default 20, max 1000) |
For a valid query
Status: 200 OK
For an invalid query
Status: 400 Bad Request
Use this endpoint to find tracks.
GET /tracks/search
Name | Type | Description |
---|---|---|
title | String | Track title |
artist | String | Artist name |
album | String | Album name |
combined | String | Query title artist and album fields |
similar_artist | String | Commercial artist |
similar_track | String | Commercial track title |
similar_ids | String | List of comma separated similar Niland track IDs |
similar_references | String | List of comma separated similar track references from your system |
similar_url | String | A Youtube video or Soundcloud track URL |
similar_url_analysis_start | Integer | Integer representing when the similar_url track analysis should start, expressed in seconds from the begining of the track |
similar_url_analysis_duration | Integer | Integer representing how long the analysis of the similar_url track should last, expressed in seconds. This value will be ignored if you do not provide the similar_url_analysis_start parameter. If not provided, the value is set to 60 seconds by default |
tag_ids | String | List of comma separated tag IDs |
or_tag_ids | String | List of comma separated tag IDs |
subsample | String | List of comma separated track IDs which defines in which tracks your are searching |
page | Integer | Page number (default 1) |
page_size | Integer | Result number per page (default 20, max 1000) |
Important: You agree that any User Content Sound that you post does not and will not violate third-party rights of any kind. You hereby represent that you are the owner of all the copyright rights and don't infringe anyone else's right.
Notice: The results are ordered by relevance, the first one being the most relevant. There is also a search_match_score which gives the similarity index between the search made and every result.
GET /tracks/search?key=...&similar_ids=1234&tag_ids=5678
For a valid query
Status: 200 OK
For an invalid query
Status: 400 Bad Request
Use those endpoints to retrieve a specific track using a track ID or a reference.
GET /tracks/{track_id}
GET /tracks/reference/{reference}
For a valid track id
Status: 200 OK
For an invalid track id or reference
Status: 404 Not Found
Use this endpoint to create a new track.
POST /tracks
Name | Type | Description |
---|---|---|
title | String | [Required] |
reference | String | [Required] |
popularity | Float | |
duration | Float | |
isrc | String | |
album | String | |
artist | String | |
audio | File | |
year | Integer | |
tags | Array | Array of Tag IDs |
Important: If you include the audio file, the content-type must be multipart/form-data
.
For a valid query
Status: 201 Created
For an invalid query
Status: 400 Bad Request
Use this endpoint to upload and analyze a track on the fly. This track can then be used in the similarity search.
POST /tracks/temporaries
Name | Type | Description |
---|---|---|
file | File | [Required] Audio file to upload and analyze |
Important: You agree that any User Content Sound that you post does not and will not violate third-party rights of any kind. You hereby represent that you are the owner of all the copyright rights and don't infringe anyone else's right.
Notice: The content-type must be multipart/form-data
.
For a valid query
Status: 201 Created
For an invalid query
Status: 400 Bad Request
Use those endpoints to edit track metadata using a Niland track ID or a reference.
PATCH /tracks/{track_id}
PATCH /tracks/reference/{reference}
Name | Type | Description |
---|---|---|
title | String | |
reference | String | |
popularity | Float | |
duration | Float | |
isrc | String | |
album | String | |
artist | String | |
year | Integer | |
tags | Array | Array of Tag IDs |
PATCH /tracks/18706931?key=...
For a valid query
Status: 200 OK
For an invalid track id or reference
Status: 404 Not Found
For an invalid query
Status: 400 Bad Request
Use those endpoints to add or change the audio file of the track using a Niland track ID or a reference.
POST /tracks/{track_id}/audio
POST /tracks/reference/{reference}/audio
Name | Type | Description |
---|---|---|
file | File |
Important: If you include the audio file, the content-type must be multipart/form-data
.
For a valid query
Status: 200 OK
For an invalid track id or reference
Status: 404 Not Found
For an invalid query
Status: 400 Bad Request
Use those endpoints to delete a track using a Niland track ID or a reference.
DELETE /tracks/{track_id}
DELETE /tracks/reference/{reference}
For a valid track id or reference
Status: 204 No Content
For an invalid track id or reference
Status: 404 Not Found
Use those endpoints to retrieve track tags (automatic tagging included) using a Niland track ID or a reference.
GET /tracks/{track_id}/tags
GET /tracks/reference/{reference}/tags
For a valid track id or reference
Status: 200 OK
For an invalid track id or reference
Status: 404 Not Found