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

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&source=curl"

Example response

{
  "success": true,
  "tags": "rex orange county pluto projector,rex orange county pluto projector lyrics,pluto projector lyrics,pluto projector rex orange county lyrics,lyrics pluto projector,rex orange county lyrics pluto projector,pluto projector,rex orange county,pluto projector rex orange county,lyrics",
  "tagsToBeRemoved": "",
  "removedTags": "rex orange county pluto projector,rex orange county pluto projector lyrics,pluto projector lyrics,pluto projector rex orange county lyrics,lyrics pluto projector,rex orange county lyrics pluto projector,pluto projector,rex orange county,pluto projector rex orange county,lyrics",
  "removedTagsLength": 295,
  "title": "Pluto Projector",
  "genre": "None",
  "artist": "Rex Orange County",
  "artistCustomFormat": 0,
  "customFormat": "",
  "features": [],
  "hashtags": ["RexOrangeCounty", "PlutoProjector", "Lyrics"],
  "tiktok": "none",
  "channel": "none",
  "log": "true",
  "extras": {
    "titles": "Rex Orange County - Pluto Projector (Lyrics)=Rex Orange County - Pluto Projector [Lyrics]=Rex Orange County - Pluto Projector",
    "seo": {
      "text": "Rex Orange County=Pluto Projector=Rex Orange County Pluto Projector Lyrics=Pluto Projector Lyrics=Pluto Projector Rex Orange County=Rex Orange County Pluto Projector"
    },
    "array": {
      "removedTags": [...],
      "titles": [...],
      "tags": [...]
    }
  },
  "url": "/api/v1/generate?title=Pluto%20Projector&artist=Rex%20Orange%20County&features=none&tiktok=false&format=lyrics&channel=none&shuffle=false&genre=none&verse=none&custom=false&log=true&response=415c9517-81cd-4164-a3bd-6c1dafeeb147&example=false&source=unknown",
  "responseId": "415c9517-81cd-4164-a3bd-6c1dafeeb147",
  "length": 295
}

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&source=curl"

Example response

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

Generate Parameters #

Parameters accepted by the /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	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 alternative emo rock edm trap electronic
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.

Params	Required	Default	Description
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:

Variables	Components	Description
{a}	artist	This is always required when using a custom format string.
{t}	title	Used to place the song title within your custom format string.
{f1}	feature-1	Used to place the first feature within your custom format string.
{f2}	feature-2	Used to place the second feature within your custom format string.
{f3}	feature-3	Used to place the third feature within your custom format string.

Note

We only support up to three features. Supporting more wouldn't help with ranking optimization, since the first 2-3 features on a song typically carry the most ranking weight, and the most well-known features are usually listed first. Viewers rarely search for a song using its full feature list.

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 Lyrics Tags Generator Bot

Installing the bot

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

Open the bot invite link.
Pick your server from the Add to Server dropdown.
Review the requested permissions and click Authorize.
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:

Command	Description
/feedback	Send feedback, suggestions, or report an issue to the developer.
/generate	YouTube metadata, only tags and hashtags data is included.
/length	Check the total character length of a generated tag string.

Note

For the /generate endpoint route, the artist component is required, the title component is not required if both the artist and title components are provided in the artist field.

/generate options

The /generate command accepts the following options:

Option	Required	Default
artist	Yes	—
format	No	Lyrics
genre	No	None
title	No	None
features	No	None
channel	No	None
shuffle	No	Yes
verse	No	None
tiktok	No	No
context	No	No

/length options

The /length command accepts the following options:

Option	Required	Default
tags	Yes	—

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.

Installing the bot

Using the bot

/generate options

/length options

Supported Formats

Lyrics

Bass Boosted

Nightcore/Sped Up

Slowed & Reverb

Letra

Testo

Phonk

None

Additional Format Templates

Christmas

Halloween