API Reference

Search for works

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

Terms to search for in title, ISWC and alternative titles.

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
administrator_publishers
array of strings
Defaults to []

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

administrator_publishers
arranger_writers
array of strings
Defaults to []

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

arranger_writers
author_writers
array of strings
Defaults to []

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

author_writers
catalogs
array of strings

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

catalogs
co_publishers
array of strings
Defaults to []

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

co_publishers
composer_writers
array of strings
Defaults to []

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

composer_writers
string

An ISWC to filter on.

original_publishers
array of strings
Defaults to []

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

original_publishers
performing_artists
array of strings
Defaults to []

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

performing_artists
string

A ref to filter on.

sub_publishers
array of strings
Defaults to []

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

sub_publishers
tags
array of strings
Defaults to []

A list of tag UUIDs to filter on (tags will be grouped by tag category, the AND boolean operarator will be used bewteen tag categories and the OR boolean operator will be used between tags within the same tag category).

tags
Headers
string
Defaults to 2026-06-29

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 16 days 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 16 days ago