Search songs
search_songsSearch a curated collection of mostly forgotten French songs by performer, title, writer, lyrics, label, or year. Find songs from remembered lyrics or specific artists.
Instructions
Search the Bide & Musique collection: French songs, mostly forgotten ones, catalogued by hand since 2000 by the association that runs the station. Bide & Musique is a French site, so French terms work best. 'search_type' picks the axis and has to be stated: 'performer' for the artist credited on the record, 'title' for the name of the song, 'writer' for who wrote or composed it, 'lyrics' for the words sung in it, 'label' for the label it came out on, 'year' for the year printed on it. Each asks a different question and they are never merged, so a name that finds nothing as a performer may still be a title. 'year' takes one four-digit year and nothing else: the site drops any other word on that axis instead of filtering on it, and the ranges its own form documents return nothing. To combine a year with words, search the words on their own axis and read each record's year from its page. Use 'lyrics' to find a song from a line someone remembers. It answers with the songs whose words match, without showing what matched; read the words themselves with get_song on the id. Several keywords are combined with AND, each matched inside words, so every extra word narrows the search and never widens it. Quoting a phrase returns nothing, whatever the site's own form says. Results carry the song id, the artist and the page to read, which is where the song's own record lives: year, label, catalogue reference and writers. The count returned counts matching songs across every page, so it is usually larger than the rows of one page; ask for the next page with 'page'. When you show a song to a user, credit Bide & Musique and link the source URL.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Which page of results to read. The answer states which page the site served. | |
| limit | No | Maximum songs to return from that page. | |
| query | Yes | What to search for, in French, for example 'Pierre Bachelet' or 'vacances'. | |
| search_type | Yes | Which axis to search: 'performer' for the artist credited on the record, 'title' for the name of the song, 'writer' for who wrote or composed it, 'lyrics' for the words sung in it, 'label' for the label it came out on, 'year' for the year printed on it. The 'year' axis takes one four-digit year and nothing else: the site drops any other word there instead of filtering on it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | Yes | ||
| query | Yes | ||
| source | Yes | ||
| results | Yes | ||
| page_count | Yes | ||
| page_served | Yes | The page the site actually served, read from its pagination bar. Asking for a page past the last one returns the last page, so this can differ from 'page_requested'. | |
| search_type | Yes | ||
| result_count | Yes | Songs returned, after 'limit'. | |
| rows_on_page | Yes | Songs this page held, before 'limit'. | |
| total_matches | Yes | The number Bide & Musique prints above the results, counting matching songs across every page. Null when the site printed none, which is different from zero. | |
| has_more_pages | Yes | ||
| page_requested | Yes |