API Reference

Search for tracks

post
https://reprtoir.io/api/tracks/search
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum
Defaults to basic

Search mode to use. The value prompt means that the query params sent will be an AI prompt search (Audio AI add-on required). The value similarity implies you must fill in the search_by_similarity params and means that the search will be an AI similarity search (Audio AI add-on required). If omitted, basic is the default value.

Allowed:
string

Terms to search for in title, subtitle, original title, original subtitle, isrc and main artist names.

search_by_similarity
object

Similarity search params to fill when search_mode is similarity.

string
enum
Defaults to _score

Sort field to use. If omitted, _score is the default value, meaning it will returns the most relevant results first.

Allowed:
string
enum
Defaults to desc

Sort order to use. If omitted, desc is the default value.

Allowed:
integer
≥ 1
Defaults to 1

The page of the results to return.

integer
1 to 100
Defaults to 10

Number of results to return for each page.

Body Params
audio_languages
array of strings

A list of language codes to filter on (OR boolean operator applied between items).

audio_languages
catalogs
array of strings

A list of catalog UUIDs to filter on (OR boolean operator applied between items).

catalogs
boolean

Filter on the exploitable status of tracks.

featured_artists
array of strings
Defaults to

A list of artist UUIDs to filter on (OR boolean operator applied between items).

featured_artists
boolean

Filter on the instrumental field of tracks.

string

An ISRC to filter on.

main_artists
array of strings
Defaults to

A list of artist UUIDs to filter on (OR boolean operator applied between items).

main_artists
boolean

Filter on the public domain status of tracks.

record_labels
array of strings
Defaults to

A list of record label UUIDs to filter on (OR boolean operator applied between items).

record_labels
string

A track reference to filter on.

ai_analysis
object

Filters based on Audio AI Analysis data.

tags
array of strings
Defaults to

A list of tag UUIDs to filter on (OR boolean operator applied between items).

tags
Headers
string
Defaults to 2024-04-11

Determines the date-based API version of your API call. If none is provided, the API version associated to your API key will be used.

Response

Updated 11 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 11 months ago