Instagram bio generator API

Say what you do and for whom, pick a tone, and get five bio drafts of 150 characters or less, or start from the bio formula and eight templates below.

• Endpoint: POST https://postboost.co/app/api/tools/instagram-bio-generator (operationId generateBio)
• Web tool: postboost.co/tools/instagram-bio-generator
• Token: required. A new generation spends 1 AI credit of the workspace you name (or your active workspace); a repeated identical request is answered from the cache for free. A scoped API key needs the ai ability and pays with its own workspace
• MCP: tool generate-bio on https://postboost.co/mcp/tools (listed only with a token)

Request

Field	Type	Default	Description
text	string		What you or your brand do, and for whom.
tone	string: friendly, professional, playful, inspirational, bold	"friendly"
emoji	boolean	true	Use one or two fitting emoji.
cta	boolean	true	End with a short call to action, such as the link in bio.
network	string: instagram	"instagram"	The network the bio is written for (Instagram for now).
workspace	string		UUID of the workspace whose AI credits pay for the call. Default: your active workspace (a scoped API key: its own workspace).

Call it

curl

curl -X POST https://postboost.co/app/api/tools/instagram-bio-generator \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"text":"Wedding photographer for small weddings in Lisbon","tone":"friendly"}'

Python

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

with ApiClient(Configuration()) as client:
    api = FreeToolsApi(client)
    result = api.generate_bio(FreeToolGenerateBioRequest.from_dict({"text": "Wedding photographer for small weddings in Lisbon", "tone": "friendly"}))
    print(result.to_dict())

Node.js

import { FreeToolsApi } from 'postboost';

const api = new FreeToolsApi();
const { body } = await api.generateBio({ text: "Wedding photographer for small weddings in Lisbon", tone: "friendly" });
console.log(body);

PHP

use PostBoostClient\Api\FreeToolsApi;
use PostBoostClient\Model\FreeToolGenerateBioRequest;

$api = new FreeToolsApi(new GuzzleHttp\Client());
$result = $api->generateBio(new FreeToolGenerateBioRequest(['text' => "Wedding photographer for small weddings in Lisbon", 'tone' => "friendly"]));
echo $result;

Go

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

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

var request postboost.FreeToolGenerateBioRequest
if err := json.Unmarshal([]byte(`{"text":"Wedding photographer for small weddings in Lisbon","tone":"friendly"}`), &request); err != nil {
    panic(err)
}

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

Ruby

require 'postboost'

api = PostBoost::FreeToolsApi.new
result = api.generate_bio(PostBoost::FreeToolGenerateBioRequest.new({ text: "Wedding photographer for small weddings in Lisbon", tone: "friendly" }))
puts result.to_hash

Java

import com.postboost.ApiClient;
import com.postboost.api.FreeToolsApi;
import com.postboost.model.FreeToolGenerateBioRequest;
import com.postboost.model.FreeToolGenerateBioResponse;

FreeToolsApi api = new FreeToolsApi(new ApiClient());
FreeToolGenerateBioRequest request = FreeToolGenerateBioRequest.fromJson("{\"text\":\"Wedding photographer for small weddings in Lisbon\",\"tone\":\"friendly\"}");
FreeToolGenerateBioResponse result = api.generateBio(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<FreeToolGenerateBioRequest>(@"{""text"":""Wedding photographer for small weddings in Lisbon"",""tone"":""friendly""}");
var result = await api.GenerateBioAsync(request);
Console.WriteLine(result.ToJson());

Rust

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

let config = Configuration::new();
let request: FreeToolGenerateBioRequest = serde_json::from_str(r##"{"text":"Wedding photographer for small weddings in Lisbon","tone":"friendly"}"##)?;
let result = free_tools_api::generate_bio(&config, request).await?;
println!("{:?}", result);

CLI

echo '{"text":"Wedding photographer for small weddings in Lisbon","tone":"friendly"}' | ./postboost-cli --content-type application/json generateBio -

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

Response

{
    "bios": [
        "Wedding photographer in Lisbon 📸\nSmall weddings, big feelings. Dates for next year: link in bio.",
        "Capturing small Lisbon weddings, one honest moment at a time 💛 Check dates via the link below.",
        "Lisbon wedding photographer for couples who keep it small.\nSee my availability in the link.",
        "Small weddings, natural photos, Lisbon light ☀️ Say hi through the link in bio.",
        "Your small Lisbon wedding, photographed with care 📷\nTap the link to check my dates."
    ],
    "credits_spent": 1,
    "cached": false
}

With MCP

Connect https://postboost.co/mcp/tools (setup) and ask, for example: Write five profile bios with AI (needs a token, spends AI credits) with the PostBoost generate-bio tool.

Errors

Status	When
401	No token, or an invalid one. The body has register_url to create a free account.
403	workspace is not a workspace you belong to, or your account has no workspace, or a scoped API key lacks the ai ability or is bound to another workspace (code: insufficient_scope).
413	The JSON body is larger than 128 KB.
422	A field is invalid; the body lists the errors per field.
429	The workspace has no AI credits left this billing cycle (code: ai_credits_exhausted, upgrade_url), or the per-minute limit is reached.
502	The AI provider failed or timed out. No credit was spent.
503	AI tools are switched off right now.