Text to Slug API

Convert any title to a URL-safe slug — handles diacritics (café → cafe), ligatures (ß → ss), &/+ expansion, configurable separator, smart truncation.

◎ Category: Text Tools ◎ Endpoint: /v1/text/slugify Method: POST Auth: API Key

Fast & Accurate

Get precise results instantly.

Easy Integration

Simple REST API with JSON response.

Developer Friendly

Clear docs and SDK examples.

Free to Start

5,000 free requests/month.

Endpoint

All requests should be made to the following endpoint:

POST https://api.tools.town/v1/text/slugify

Authentication

This endpoint requires an API Key. Include your API key in the request header.

Authorization: Bearer YOUR_API_KEY

You can get your API key from your dashboard.

Request Parameters

Send a POST request with JSON body.

Parameter	Type	Required	Description	Example
`text`	`string`	✓	The text parameter.	`Hello World`
`separator`	`enum`	✕	The separator parameter.	`-`
`lowercase`	`boolean`	✕	The lowercase parameter.	`true`
`maxLength`	`number`	✕	The maxLength parameter.	`100`

Example Request

curl -X POST "https://api.tools.town/v1/text/slugify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello World"
  }'

import requests

response = requests.post(
    "https://api.tools.town/v1/text/slugify",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "text": "Hello World"
    }
)
print(response.json())

<?php
$ch = curl_init("https://api.tools.town/v1/text/slugify");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer YOUR_API_KEY",
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  "text" => "Hello World"
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
echo $result;

const response = await fetch("https://api.tools.town/v1/text/slugify", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    text: "Hello World"
  }),
});

const data = await response.json();
console.log(data);

const fetch = require("node-fetch");

const response = await fetch("https://api.tools.town/v1/text/slugify", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    text: "Hello World"
  }),
});

const data = await response.json();
console.log(data);

Example Response 200 OK

application/json

{
  "success": true,
  "data": {
    "slug": "string",
    "length": "0",
    "truncated": "true"
  }
}

Error Codes

Code	Meaning
400	Bad Request — missing or invalid parameter
401	Unauthorized — API key missing or invalid
429	Rate limit exceeded — free tier: 5,000 requests/month
500	Internal Server Error — try again or contact support

All API Tools Try Text to Slug →

AI Text Summarizer

AI Image Packs