stye_search_tracks
Find music for a scene or brief
Searches the Songs To Your Eyes production-music catalogue for cues that fit a brief for a video, film, advert, trailer or podcast: music to license for a project, or anything about the Songs To Your Eyes catalogue.
The brief is matched by MEANING against an editorial description of how each cue behaves
as well as against its tags, so a described scene, mood, instrumentation or arc ("tense
investigative underscore that never resolves", "warm and hopeful for a charity film")
matches far better than a single keyword.
LISTENING. Each result carries listen_url, a permanent public page where that cue plays.
It is the only way a person can hear a cue: a cue listed without its listen_url cannot be
auditioned. This holds for every list, an album listing included.
PRIVACY. When a brief has not been searched before, its text is sent to Google's Gemini
API to interpret it; no identifier is sent.
FILTERS. Every filter is a hard constraint. Filters combine with AND, and a cue missing
the tag a filter tests is excluded, so several filters together can empty a page. The
brief carries soft qualities without excluding anything.
PAGES. One call returns one page of up to 25 cues (default 15); there is no pagination,
and identical arguments return identical cues. A different brief, or the same need
phrased from a different angle, returns different cues.
VOCALS. has_vocals=true selects songs with sung lead vocals and lyrics. Wordless vocal
textures (background vocals, oohs and aahs, choir pads) are classed as instrumental,
has_vocals=false; a request for "background vocals" is almost always a request for no
lyrics. Texture words in the brief ("background vocals", "choir", "vocal hooks", "group
singing") are detected server-side and applied as a hard requirement, so every result
carries that texture and a short page reflects the catalogue's actual supply of it.
COMPOSERS. The composer filter matches the credited composer by partial name, with or
without a brief (with none, it list
Parameterskeyalbumbrieflimitmoodsenergygenresbpm_maxbpm_mincontextexcludecomposer+7 more
stye_fit_to_duration
Find music that fits a runtime
Finds cues that fit an exact runtime, for a cut of known length such as a 30-second advert or a 90-second title sequence: music to license for a project, or anything about the Songs To Your Eyes catalogue.
Two kinds of result come back. Some cues already run close to the target length (fit='native'). Others are purpose-made short edits of a longer piece, cut down by the composer (fit='cutdown'), built to land on time rather than fade out.
delta_s is how far each result sits from the target, negative meaning shorter. For a cutdown, licence_ref identifies that specific edit (the thing to license), while ref points at the full-length original that carries the description and the preview.
Every result carries listen_url, a permanent public page where the cue plays, with cover art and a waveform. It is the only way a person can hear a cue: a cue listed without its listen_url cannot be auditioned.
The brief is matched on Songs To Your Eyes' own servers; it is not sent to any third-party AI service.
Parametersbrieflimitmoodscomposerhas_vocalstarget_secondsrequiredinclude_previewstolerance_seconds
stye_get_track
Get full details for one track
Everything about one cue: what it sounds like and suits, its tempo, key, length and instrumentation, every version that exists of it (stems, shorter cuts, alternate mixes) and its listen_url. For a track already found, or for what else a cue can be delivered as.
Every result carries listen_url, a permanent public page where the cue plays, with cover art and a waveform. It is the only way a person can hear a cue: a cue listed without its listen_url cannot be auditioned.
Parametersrefrequired
stye_list_versions
List versions, stems and shorter cuts
Every form a cue can be delivered in: the full-length mix plus, where they exist, timed cutdowns (15, 30, 60 seconds) built for standard ad and promo lengths, alternate mixes such as no-drums, underscore or instrumental for music that sits beneath dialogue, and individual instrument stems for rebalancing a track. A little under half of the catalogue's cues have at least one of these. Each version carries its own listen_url. Relevant when a cue is nearly right but needs to be shorter, quieter under a voice, or stripped back.
Parametersrefrequired
stye_cue_sheet
Cue sheet: writers, splits, ISRC, publisher
The clearance data a broadcaster or PRO filing needs for one cue: every credited writer with role, society and IPI, every publisher with its share, the ISRC and the album. A field missing from the response is not on file in the catalogue; [email protected] handles gaps. Licensing is arranged with the Songs To Your Eyes team, outside these tools.
Parametersrefrequired
stye_find_similar
Find similar cues
Cues close in character to a given one, matched on the catalogue's editorial description of each cue together with its genres, moods and instrumentation, for 'more like this one' moments. It compares how cues are described, not their waveforms, so it is strong on character and mood and does not detect two cues as alike purely because they sound alike. Results are main mixes from other cue families, at most three per album, each with its listen_url.
Parametersrefrequiredlimit
stye_about
About Songs To Your Eyes: licensing and privacy
What this service is, how licensing works and what the server sees: the service's own licensing and privacy statements, with links to the full legal terms and the privacy policy.
Takes no parameters.
stye_feedback
Report result quality
Sends a short message to the catalogue team about how well results fit: a wrong-feeling page, a brief that found nothing, or praise worth keeping. It sends only with consented=true, which records that the user explicitly agreed to send this message; without it, nothing is sent. The message is stored with the brief and track it concerns and no user identifier (https://mcp.songstoyoureyes.com/privacy).
Parametersrefkindbriefmessagerequiredconsentedrequired