How to generate a URL slug from a title with an API

Updated 2026-11-16

Use when an agent must turn a title or phrase into a URL-friendly slug.

From an MCP client, add https://tanod.dev/mcp and call make_slug; its free daily calls are applied automatically, no key or signup.

POST text to /v1/slug. It returns a URL-safe slug: accents removed, ligatures and Greek and Cyrillic transliterated, apostrophes dropped, other characters turned into one separator.

Request

text is up to 1,000 characters. Optional: separator (- default or _), max_length 1 to 200 (default 80, cut at a separator) and lowercase (default true).

curl, using the free tier
curl -s -X POST https://tanod.dev/v1/slug \
  -H 'X-Tanod-Free: 1' -H 'content-type: application/json' \
  -d '{"text": "Crème Brûlée: 10 Tips & Tricks"}'

Two more optional fields fit the slug to one language. language sets the letter rules: de writes ä, ö and ü as ae, oe and ue; da, nb, nn or no write ø and å as oe and aa; ca writes l·l as ll; sr or bs write đ as dj. Without it, ü becomes u. and_word (1 to 20 characters) writes & as that word, and & is dropped when it is left out.

Request body and the slug it returns
{"text": "Größe & Ökonomie"}                      grosse-okonomie
{"text": "Größe & Ökonomie", "language": "de"}    groesse-oekonomie
{"text": "Größe & Ökonomie", "and_word": "und"}   grosse-und-okonomie

Response

Response (example from the API spec, trimmed)
{
  "slug": "creme-brulee-10-tips-tricks",
  "length": 27,
  "truncated": false,
  "transliterated": true,
  "dropped_characters": 0,
  "source": {
    "library": "own implementation (unicodedata NFKD + transliteration tables)",
    "license": "n/a"
  }
}

Limits and caveats

CJK, Arabic, Hebrew, Indic, Thai and emoji are not romanised. They are removed and counted in dropped_characters. Check it before you use the slug for such titles.

Two different titles can give the same slug; check your own store for collisions.

Text with nothing left to slug is a 422 empty_slug and is not charged.

Doing this by hand? Use the free text to slug converter in your browser.

Price and free allowance

USD 0.001 per call, paid in USDC on Base, Polygon, Solana, BNB Chain or Arbitrum with x402. 10 free calls per IP per UTC day with the header X-Tanod-Free: 1. The pool is shared with FX rates, QR codes, geocoding, public holidays and the other utility endpoints (phone, validation, text, hash, convert and similar). MCP tool: make_slug at https://tanod.dev/mcp, where the free tier is automatic.

All endpoints →

Use it from Claude without writing code: in claude.ai or Claude Desktop, add https://tanod.dev/mcp/text?via=slug-generator-api as a custom connector (steps), then ask in plain words, for example "Make a URL slug from the title 'Ten Tips for Better Sleep!'." The free daily allowance is applied automatically over MCP. Beyond it a call needs an x402 payment, which these clients can make.

Related guides: How to generate UUID v4, UUID v7 and ULID values with an API, How to parse a URL into domain, subdomain, path and query with an API, How to count words and score readability of a text with an API. Back to tanod.dev or the guide index. Results are automated and heuristic.