Social media username generator API

Type your name, brand or a few keywords, pick a network and a style, and get 30 username ideas that fit that network's length and character rules.

• Endpoint: POST https://postboost.co/app/api/tools/social-media-username-generator (operationId generateUsernames)
• Web tool: postboost.co/tools/social-media-username-generator
• Token: optional (limits)
• MCP: tool generate-usernames on https://postboost.co/mcp/tools

Request

Field	Type	Default	Description
name	string		Your name, brand or a few keywords. Accents are dropped; only Latin letters and digits are used.
network	string: instagram, tiktok, x, youtube, threads	"instagram"	Whose username rules apply (Threads uses your Instagram username).
style	string: clean, creative, business, gaming	"clean"	Which word list to mix in.
numbers	boolean	false	Allow a number at the end of some names.
seed	integer	0	The same input and seed give the same list; change it for more ideas.

Call it

curl

curl -X POST https://postboost.co/app/api/tools/social-media-username-generator \
  -H 'Content-Type: application/json' \
  -d '{"name":"Maya Green"}'

Python

from postboost import ApiClient, Configuration
from postboost.api.free_tools_api import FreeToolsApi
from postboost.models import FreeToolGenerateUsernamesRequest

with ApiClient(Configuration()) as client:
    api = FreeToolsApi(client)
    result = api.generate_usernames(FreeToolGenerateUsernamesRequest.from_dict({"name": "Maya Green"}))
    print(result.to_dict())

Node.js

import { FreeToolsApi } from 'postboost';

const api = new FreeToolsApi();
const { body } = await api.generateUsernames({ name: "Maya Green" });
console.log(body);

PHP

use PostBoostClient\Api\FreeToolsApi;
use PostBoostClient\Model\FreeToolGenerateUsernamesRequest;

$api = new FreeToolsApi(new GuzzleHttp\Client());
$result = $api->generateUsernames(new FreeToolGenerateUsernamesRequest(['name' => "Maya Green"]));
echo $result;

Go

import (
    "context"
    "encoding/json"
    "fmt"

    postboost "github.com/postboost-co/postboost-go"
)

var request postboost.FreeToolGenerateUsernamesRequest
if err := json.Unmarshal([]byte(`{"name":"Maya Green"}`), &request); err != nil {
    panic(err)
}

client := postboost.NewAPIClient(postboost.NewConfiguration())
result, _, err := client.FreeToolsAPI.GenerateUsernames(context.Background()).FreeToolGenerateUsernamesRequest(request).Execute()
fmt.Println(result, err)

Ruby

require 'postboost'

api = PostBoost::FreeToolsApi.new
result = api.generate_usernames(PostBoost::FreeToolGenerateUsernamesRequest.new({ name: "Maya Green" }))
puts result.to_hash

Java

import com.postboost.ApiClient;
import com.postboost.api.FreeToolsApi;
import com.postboost.model.FreeToolGenerateUsernamesRequest;
import com.postboost.model.FreeToolGenerateUsernamesResponse;

FreeToolsApi api = new FreeToolsApi(new ApiClient());
FreeToolGenerateUsernamesRequest request = FreeToolGenerateUsernamesRequest.fromJson("{\"name\":\"Maya Green\"}");
FreeToolGenerateUsernamesResponse result = api.generateUsernames(request);
System.out.println(result.toJson());

C#

using Newtonsoft.Json;
using PostBoost.Client.Api;
using PostBoost.Client.Client;
using PostBoost.Client.Model;

var api = new FreeToolsApi(new Configuration());
var request = JsonConvert.DeserializeObject<FreeToolGenerateUsernamesRequest>(@"{""name"":""Maya Green""}");
var result = await api.GenerateUsernamesAsync(request);
Console.WriteLine(result.ToJson());

Rust

use postboost::apis::configuration::Configuration;
use postboost::apis::free_tools_api;
use postboost::models::FreeToolGenerateUsernamesRequest;

let config = Configuration::new();
let request: FreeToolGenerateUsernamesRequest = serde_json::from_str(r##"{"name":"Maya Green"}"##)?;
let result = free_tools_api::generate_usernames(&config, request).await?;
println!("{:?}", result);

CLI

echo '{"name":"Maya Green"}' | ./postboost-cli --content-type application/json generateUsernames -

With a token, send Authorization: Bearer YOUR_API_TOKEN as a default header (how, per SDK).

Response

{
    "network": "instagram",
    "style": "clean",
    "seed": 0,
    "usernames": [
        {
            "username": "space_maya",
            "profile_url": "https://www.instagram.com/space_maya"
        },
        {
            "username": "club.maya",
            "profile_url": "https://www.instagram.com/club.maya"
        },
        {
            "username": "maya_club_life",
            "profile_url": "https://www.instagram.com/maya_club_life"
        },
        {
            "username": "hey_maya_now",
            "profile_url": "https://www.instagram.com/hey_maya_now"
        },
        {
            "username": "heymayagreen",
            "profile_url": "https://www.instagram.com/heymayagreen"
        },
        {
            "username": "hey_maya",
            "profile_url": "https://www.instagram.com/hey_maya"
        },
        {
            "username": "just_maya_green",
            "profile_url": "https://www.instagram.com/just_maya_green"
        },
        {
            "username": "maya_green_view",
            "profile_url": "https://www.instagram.com/maya_green_view"
        },
        {
            "username": "green.sunny",
            "profile_url": "https://www.instagram.com/green.sunny"
        },
        {
            "username": "maya_world",
            "profile_url": "https://www.instagram.com/maya_world"
        },
        {
            "username": "mayapagenow",
            "profile_url": "https://www.instagram.com/mayapagenow"
        },
        {
            "username": "studio_green",
            "profile_url": "https://www.instagram.com/studio_green"
        },
        {
            "username": "mg_fresh",
            "profile_url": "https://www.instagram.com/mg_fresh"
        },
        {
            "username": "maya_green_days",
            "profile_url": "https://www.instagram.com/maya_green_days"
        },
        {
            "username": "meet.maya.green",
            "profile_url": "https://www.instagram.com/meet.maya.green"
        },
        {
            "username": "mayanotes",
            "profile_url": "https://www.instagram.com/mayanotes"
        },
        {
            "username": "mayagreenhere",
            "profile_url": "https://www.instagram.com/mayagreenhere"
        },
        {
            "username": "only.maya.green",
            "profile_url": "https://www.instagram.com/only.maya.green"
        },
        {
            "username": "truemg",
            "profile_url": "https://www.instagram.com/truemg"
        },
        {
            "username": "maya_green_sunny",
            "profile_url": "https://www.instagram.com/maya_green_sunny"
        },
        {
            "username": "mayaonline",
            "profile_url": "https://www.instagram.com/mayaonline"
        },
        {
            "username": "its.maya.world",
            "profile_url": "https://www.instagram.com/its.maya.world"
        },
        {
            "username": "simplymayadays",
            "profile_url": "https://www.instagram.com/simplymayadays"
        },
        {
            "username": "page_green",
            "profile_url": "https://www.instagram.com/page_green"
        },
        {
            "username": "waymg",
            "profile_url": "https://www.instagram.com/waymg"
        },
        {
            "username": "only_maya_green",
            "profile_url": "https://www.instagram.com/only_maya_green"
        },
        {
            "username": "green_space",
            "profile_url": "https://www.instagram.com/green_space"
        },
        {
            "username": "sunny.mg",
            "profile_url": "https://www.instagram.com/sunny.mg"
        },
        {
            "username": "calm_green",
            "profile_url": "https://www.instagram.com/calm_green"
        },
        {
            "username": "green.moments",
            "profile_url": "https://www.instagram.com/green.moments"
        }
    ],
    "rules": {
        "min_length": 1,
        "max_length": 30,
        "separators": [
            ".",
            "_"
        ]
    }
}

With MCP

Connect https://postboost.co/mcp/tools (setup) and ask, for example: Generate social media usernames with the PostBoost generate-usernames tool.

Errors

Status	When
401	The Authorization header holds an invalid token. Leave it out to call as a guest.
413	The JSON body is larger than 128 KB.
422	A field is invalid; the body lists the errors per field.
429	A limit is reached; see limits.