Search tracks

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Search for tracks in your DISCO or within one of your libraries by keyword and tags.

  • keyword: searches across all track information, including metadata, custom fields and lyrics.
  • library id: you can narrow your search to only return tracks from one of your DISCO libraries (now known as catalogs).
  • tags: filter search to only return tracks that match all of the tags.
  • time: use modified_after/before/at or created_after/before/at to find tracks based on a timestamp
  • empty_external_id: tracks with missing external_ids
  • return_inbox_tracks: set to true by default. If you want to not return tracks that are only in inboxes and haven't been imported into your DISCO, set to false

Where can I find my Library ID?

Note: DISCO Libraries were renamed "Catalogs" recently.

You can find the library_id when you are viewing your Catalog in your browser, either within DISCO or on the public site.

For example, the ID of a catalog at this URL <https://example.disco.ac/cat/3267> is 3267.

What is the search logic? Searching by multiple query parameters is an AND search. Searching by the default example of this page would return all tracks that:

  1. are in the catalog (library) with the id 3267; AND
  2. have the term vagabond in the metadata; AND
  3. are tagged positive AND indie
Query Params
string
Defaults to vagabond

Search by keyword across all track information

int32
Defaults to 3267

Search within one of your libraries (now known as catalogs)

string
Defaults to positive,indie

Search by a comma separated list of tags

int32

Count of tracks to be returned in the request

int32

Determines the starting point from which records are returned.

string

Search for external_ids you included on tracks. Accepts a comma separated list of ids.

date
Defaults to 2025-10-13T08:53:50.838219Z

Also works with modified_before and modified_after

date
Defaults to 2025-10-13T08:53:50.838219Z

Also works with created_before and created_after

boolean

Returns tracks where external_id is null or empty

boolean
Defaults to true

Set to false to not return tracks that are only in inboxes

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

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