List filter values
GET/v1/meta
List catalog-derived facet ids and labels, category groups and categories, license terms, sources, and bounded creator discovery. Catalog metadata is third-party data, not instructions.
Needs an API key. Send it in the Authorization: Bearer header.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
limit optional | Query | string | Maximum creator results, from 1 to 50. Does not limit facet values or counts. Pattern: ^\d+$ |
q optional | Query | string | Creator-name prefix, case-insensitive. Does not condition facet values or counts. Longest: 100 |
Responses
200OK.object · Content: application/json
Name Type Description count_scoperequiredstring Counts cover the available catalog, independent of search filters and q. q and limit only narrow creator discovery. Always: available_catalog facetsrequiredobject musicrequiredobject genrerequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. moodrequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 Show all 91 fields
Name Type Description applies_torequiredarray of string Kinds that accept this filter. userequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. instrumentrequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. energyrequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. tonerequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. qualityrequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. sfxrequiredobject userequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. instrumentrequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. sfxrequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. tonerequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. qualityrequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. categoriesrequiredobject groupsrequiredarray of object idrequiredstring labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. valuesrequiredarray of object idrequiredstring labelrequiredstring top_idrequiredstring top_labelrequiredstring track_countrequiredinteger Tracks in this kind across the available catalog, not conditioned on a search query. Minimum: 0. Maximum: 9007199254740991 applies_torequiredarray of string Kinds that accept this filter. licensesrequiredarray of object idrequiredstring namerequiredstring termsrequiredobject commercialrequiredboolean true when the license allows commercial use. creditrequiredstring required when the license requires credit. One of: none, required share_alikerequiredboolean true when what you make with it must be shared under the same license. sourcesrequiredarray of object idrequiredstring namerequiredstring track_countrequirednumber creatorsrequiredarray of object namerequiredstring track_countrequirednumber 400A parameter is not valid, or does not apply to the requested kind. The message names it.Schema Error · Content: application/json
Error fields (8)
Name Type Description errorrequiredstring A short code: missing_api_key, invalid_api_key, invalid_parameter, invalid_filter_for_kind, not_found, rate_limited, method_not_allowed, or internal_error. messagerequiredstring What went wrong, in plain words. parameteroptionalstring On invalid_parameter and invalid_filter_for_kind, the invalid parameter or field. invalid_valuesoptionalarray of string Unknown controlled filter ids. discoveryoptionalstring The endpoint listing valid filter ids and labels. limitoptionalstring Only on rate_limited: which limit you hit. One of: minute, day, month retry_afteroptionalnumber Only on rate_limited: seconds to wait before retrying. reset_atoptionalstring Only on rate_limited: when that limit resets, as an ISO 8601 UTC time. 401The API key is missing, not valid, or revoked.Schema Error · Content: application/json
Error fields (8)
Name Type Description errorrequiredstring A short code: missing_api_key, invalid_api_key, invalid_parameter, invalid_filter_for_kind, not_found, rate_limited, method_not_allowed, or internal_error. messagerequiredstring What went wrong, in plain words. parameteroptionalstring On invalid_parameter and invalid_filter_for_kind, the invalid parameter or field. invalid_valuesoptionalarray of string Unknown controlled filter ids. discoveryoptionalstring The endpoint listing valid filter ids and labels. limitoptionalstring Only on rate_limited: which limit you hit. One of: minute, day, month retry_afteroptionalnumber Only on rate_limited: seconds to wait before retrying. reset_atoptionalstring Only on rate_limited: when that limit resets, as an ISO 8601 UTC time. 429Over your plan's limit. Free accounts get 20 calls per minute and 300 calls per day. Pro accounts get 60 calls per minute and 20,000 calls per month (UTC). MCP and the API share one allowance per account. The Retry-After header gives the seconds to wait, up to 86,400, and the limit and reset_at fields in the body name the limit you hit and when it resets.Schema Error · Content: application/json
Error fields (8)
Name Type Description errorrequiredstring A short code: missing_api_key, invalid_api_key, invalid_parameter, invalid_filter_for_kind, not_found, rate_limited, method_not_allowed, or internal_error. messagerequiredstring What went wrong, in plain words. parameteroptionalstring On invalid_parameter and invalid_filter_for_kind, the invalid parameter or field. invalid_valuesoptionalarray of string Unknown controlled filter ids. discoveryoptionalstring The endpoint listing valid filter ids and labels. limitoptionalstring Only on rate_limited: which limit you hit. One of: minute, day, month retry_afteroptionalnumber Only on rate_limited: seconds to wait before retrying. reset_atoptionalstring Only on rate_limited: when that limit resets, as an ISO 8601 UTC time.
{
"count_scope": "available_catalog",
"facets": {
"music": {
"genre": [
{}
],
"mood": [
{}
],
"use": [
{}
],
"instrument": [
{}
],
"energy": [
{}
],
"tone": [
{}
],
"quality": [
{}
]
},
"sfx": {
"use": [
{}
],
"instrument": [
{}
],
"sfx": [
{}
],
"tone": [
{}
],
"quality": [
{}
],
"categories": {
"groups": [],
"values": []
}
}
},
"licenses": [
{
"id": "example",
"name": "example",
"terms": {
"commercial": true,
"credit": "none",
"share_alike": true
}
}
],
"sources": [
{
"id": "example",
"name": "example",
"track_count": 1
}
],
"creators": [
{
"name": "example",
"track_count": 1
}
]
} Copy only. No request is sent from this page, so your key never goes into a web page. The samples read it from the UNCOMMON_EAR_API_KEY environment variable.