Skip to main content

Changelog 2021-12-07

· 2 min read
Laurin Quast

New augmented keywords and keyword search.

Augmented keywords

We are happy to announce our stable API for retrieving the augmented keywords via the Track.augmentedKeywords field.

The taxonomy of 1500 keywords from the categories the categories mood, genre, situations, brand values and style describes a LibraryTrack or SpotifyTrack.

For example the wonderful song Break - Never Say Never gives us the following taxonomy:

action
banger
menacing
powerful
energy
electronic
uplifting
dirty
energetic
gritty
imposing
aggressive
ominous
dark
driving
scary
sinister
forceful
angry

If you are interested in this feature reach out to our sales team via sales@cyanite.ai.

Get started by heading over to our augmented keywords guide.

In addition to the augmented keywords we now expose the keyword search that allows finding tracks from your library, crate or spotify based on a weighted keyword input. You can search and filter by up to 10 weighted keywords.

query KeywordSearchQuery {
keywordSearch(
target: { spotify: {} }
keywords: [
{ keyword: "sparkling", weight: 0.5 }
{ keyword: "sad", weight: -1.0 }
{ keyword: "rock", weight: 1 }
{ keyword: "dreamy", weight: 1 }
]
) {
__typename
... on KeywordSearchError {
message
code
}
... on KeywordSearchConnection {
edges {
node {
id
title
}
}
}
}
}

A single keyword can be weighted from the range -1 to +1. The example input sparkling: 0.5, sad: -1, rock: 1, dreamy: 1, would refer to a search for a rock track which is dreamy, slightly sparkling and not at all sad.

If you are interested in this feature reach out to our sales team via sales@cyanite.ai.

Learn more in our keyword search guide.