Advanced metadata search

GET

/search

• Production server — the live, publicly accessible deployment of the Songbook API.

Search the songbook using one or more musical metadata parameters. All provided parameters are combined additively (AND logic), allowing precise filtering by genre, musical key, and tempo.

Parameters

Query Parameters

genre

string

Filter songs by musical genre (e.g. rock, jazz, pop). Returns only songs matching the specified genre.

key

string

Filter songs by musical key (e.g. C major, A minor). Useful for matching songs to a consistent tonal centre in a set.

tempo

string

Allowed values: slow medium fast

Filter songs by their general tempo or energy level. Accepted values are slow, medium, or fast.

Responses

200

A JSON array of songs matching all provided filter criteria, each with full metadata.

Array<object>

object

id

integer

title

string

artist

string

decade

string

genre

string

musical_metadata

A collection of performance-specific musical attributes that describe how the song is played live, including key and tempo.

object

key

The musical key in which the song is performed (e.g. G major, E minor). Useful for transposition and harmonic planning.

string

tempo

The general tempo or energy feel of the performance. One of: slow, medium, or fast.

string

Allowed values: slow medium fast