This is awkward! This site only supports desktop size screens.
Documentation
Our official documentation.
Endpoints
Here are the available endpoints that we provide:
What To Provide
If you plan to consume our public Application Programming Interface (API) then here are some of the available parameters that you can provide when making requests to our /v1/generate endpoint.
| Params | Required | Default | Description |
|---|---|---|---|
| artist | Yes | none | Name of the artist. You can provide both the artist and the title components in this field, e.g. Rex Orange County – Pluto Projector is appropriate. |
| title | Yes | none | Name of the song. Not required if both the artist and title components are provided in the artist parameter. |
| features | No | none | Featured artists. If you provide more than 3 featuring artists, then only the first 3 features will be used when generating the tags. |
| tiktok | No | false | Provides additional tags related to TikTok, It's recommended for songs that are performing well on TikTok (true / false). |
| channel | No | none | The name of the YouTube channel you want featured in the generated tags. |
| format | No | lyrics |
|
| shuffle | No | false | The option to shuffle the generated tags (true or false). |
| genre | No | none |
|
| verse | No | none | 3 short verses. Each individual verse should be separated by a comma. |
| custom | No | none | The custom format string template that you want to use. |
| log | No | true | All request data (generated metadata) is logged for debugging purposes, if you wish to not have your data logged, then provide false as the parameter value. |
| webhook | No | none | Request data is logged in private Discord text channels. You may optionally provide a webhook link to log data in your own private channel. Your webhook link is never stored or logged. |
For the /v1/length endpoint, here's what you need to provide:
| Params | Required | Default | Description |
|---|---|---|---|
| tags | Yes | none | The generated tags you want to find the length for. |
Custom String Template
We also allow you to define your own custom string template for generated tags. Here's what a string template typically looks like this:
{a} {t} lyrics,{t} lyrics,lyrics {t},{a} {t}
You might be wondering what the {} parts are, we call them variables, and the letters inside them signify where the components of a song belong to. Let's take this song for example:
Rex Orange County – Pluto Projector
We break down the song into components and place them into their respective parts. {a} is for the 'artist' and {b} is for the 'title'. To use your custom string template, you must provide the song followed by a forward slash which is then followed by the string template you want to use. Here's an example:
Rex Orange County - Pluto Projector/{a} {t} lyrics,{t} lyrics,lyrics {t},{a} {t}
Here are the available variables you can use in your custom string template:
| Variables | Required | Description |
|---|---|---|
| {a} | artist | Artist component of a song. |
| {t} | title | Title component of a song. |
| {f1} | feature@{1} | First featured artist of a song. |
| {f2} | feature@{2} | Second featured artist of a song. |
| {f3} | feature@{3} | Third featured artist of a song. |
Note:
Additional Tags
We also provide the functionality that will allow you to generate additional tags based on seasonal events. The only seasonal events we support are Halloween and Christmas. This is how you generate additional tags:
Let's say you want to generate Christmas additional tags for the following song:
Rex Orange County – Pluto Projector
You would need to append the \christmas flag after the end of the song, here's how it would look:
Rex Orange County – Pluto Projector\christmas
Here's the resulting tags:
rex orange county pluto projector lyrics
pluto projector lyrics
lyrics pluto projector
rex orange county pluto projector
christmas songs
christmas music
christmas 2026
christmas playlist
Note:
Further Assistance
If you have any questions or need further assistance, feel free to reach out to me at hi@notnick.io