This is awkward! This site only supports desktop size screens.

API Reference

Documentation

A free, public API that generates SEO-optimized YouTube metadata for your lyric videos, including tags, titles, hashtags, and keywords.

Base URL

tags.notnick.io/api

Authentication

None

Response

JSON

Introduction#

Everything you need to start generating metadata programmatically.

The Lyrics Tags Generator API is completely free and requires no API key. Send a GET request to one of the endpoints below and you'll receive a JSON response. All parameters are passed as query string values.

Endpoints#

The available endpoints, with example requests and responses.

GET/api/v1/generate

Generate optimized YouTube tags, title suggestions, hashtags, and SEO metadata for a song.

Example request

curl "https://tags.notnick.io/api/v1/generate?\
artist=Rex%20Orange%20County%20-%20Pluto%20Projector&format=lyrics"

Example response

{
  "success": true,
  "artist": "Rex Orange County",
  "title": "Pluto Projector",
  "tags": "rex orange county pluto projector lyrics,pluto projector lyrics,lyrics pluto projector,rex orange county pluto projector",
  "length": 117,
  "hashtags": ["#rexorangecounty", "#plutoprojector", "#lyrics"],
  "responseId": "f3a9c1e2"
}
GET/api/v1/length

Calculate the total character length of a comma-separated tag string.

Example request

curl "https://tags.notnick.io/api/v1/length?\
tags=pluto%20projector%20lyrics,lyrics%20pluto%20projector"

Example response

{
  "success": true,
  "length": 41
}

Generate Parameters#

Parameters accepted by the /v1/generate endpoint.

ParamsRequiredDefaultDescription
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
  • lyrics
  • bassboosted
  • nightcore
  • slowed
  • letra
  • phonk
  • testo
  • none
shuffle
No
false

The option to shuffle the generated tags (true or false).

genre
No
none
  • none
  • country
  • latin
  • phonk
  • dance
  • pop
  • rap
  • italian
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.

Length Parameters#

Parameters accepted by the /v1/length endpoint.

ParamsRequiredDefaultDescription
tags
Yes
none

The generated tags you want to find the length for. Pass the raw comma-separated tag string returned from the /generate endpoint.

Custom String Template#

Define your own template to control exactly how generated tags are structured.

{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:

VariablesComponentsDescription
{a}
artist

he main artist's name. This is always required when using a custom format string.

{t}
title

The title of the song. Used to place the song title within your custom format string.

{f1}
feature@{1}

The first featured artist. Used to place the first feature within your custom format string.

{f2}
feature@{2}

The second featured artist. Used to place the second feature within your custom format string.

{f3}
feature@{3}

The third featured artist. Used to place the third feature within your custom format string.

Note

We only support three features.

Additional Tags#

Append seasonal tags for events like Halloween and Christmas.

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

Click here to see the available additional tags format

Note

Propose new additional tags by creating an issue on GitHub with your suggestion.

Discord Bot#

Generate tags directly from your Discord server.

Prefer to stay in Discord? The Lyrics Tags Generator is also available as a Discord bot, so you and your members can generate YouTube metadata with a few slash commands.

Add to Discord

Installing the bot

You'll need the Manage Server permission on the server you want to add the bot to.

  1. Open the bot invite link.
  2. Pick your server from the Add to Server dropdown.
  3. Review the requested permissions and click Authorize.
  4. Complete the captcha if prompted.
  5. The bot will appear in your server's member list, ready to use.

Using the bot

In any channel the bot can access, you can run the following slash commands:

CommandDescription
/feedbackSend feedback, suggestions, or report an issue to the developer.
/lengthCheck the total character length of a generated tag string.
/generateGenerate YouTube metadata for a song.

Note

For /generate, artist is required, while title is not required if both the artist and title are provided in the artist field.
Running the /generate command with the Lyrics Tags Generator Discord bot, showing the generated tags, hashtags, length, and a downloadable tags.txt file.
Generating tags for a song with the /generate command.
Running the /length command with the Lyrics Tags Generator Discord bot, which replies with the character length of the generated tags.
Checking the length of tags with the /length command.

Format Templates#

The format string templates we use for every supported and additional format.

Every format is built from a format string template: a comma-separated list of tag patterns where variables are swapped out for the song's components. The available variables are {artist}, {title}, {firstFeature}, {secondFeature}, and {thirdFeature}.

Each format has several templates, chosen based on the constraint shown above it. The constraint reflects how many featured artists are present (feature-1, feature-2, feature-3) and whether TikTok tags are enabled (@tiktok=true@).

Supported Formats

Additional Format Templates

View the full format reference

Further Assistance#

If you have any questions or need further assistance, feel free to reach out to me at hi@notnick.io.