---
title: "Convert any text to a URL-safe slug"
method: POST
path: "/slugify.php"
tags: ["text"]
---

# Convert any text to a URL-safe slug

`POST /slugify.php`

## Request

- Base URL: `https://mate.tools/api/v1`
- URL: `https://mate.tools/api/v1/slugify.php`
- Auth: none declared

Produces a URL-safe slug. Unicode-aware: by default, accented and non-Latin characters are transliterated to ASCII (set `transliterate=false` to keep them). Configurable separator (`-`, `_`, `.`, `~`) and max length.

## Request body

- object
  - `text` string, required
  - `separator` string
  - `max_length` integer
  - `lowercase` boolean
  - `transliterate` boolean

## Response `200`

Success

## Other responses

- `400`: Malformed request
- `429`: Rate limit exceeded (60/min, 600/hour per IP). Includes Retry-After header.

---

[API](https://skmtc.dev/mate/apis/mate-tools-api.md) · [All operations](https://skmtc.dev/mate/apis/mate-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mate/apis/mate-tools-api/revisions/874670b78962?raw)