API · v1
TontonTools Developer API
A free, fast REST API for 25+ tools — word counting, hashing, encoding, UUIDs, JSON utilities and more. JSON in, JSON out. Get a key in seconds.
Get your free API key
No account needed. 60 requests/minute, 1,000/day — plenty for most projects.
Try it live
Pick a tool, paste your API key, and run a real request against the API.
Quick start
Base URL: https://tonton-tools.com/api/v1 — authenticate with the X-API-Key header. All responses are JSON with an ok field. Full OpenAPI spec available.
cURL
curl -X POST https://tonton-tools.com/api/v1/word-counter \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"The quick brown fox."}'
JavaScript (fetch)
const res = await fetch("https://tonton-tools.com/api/v1/word-counter", {
method: "POST",
headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ text: "The quick brown fox." })
});
const data = await res.json();
console.log(data.result);
PHP
$ch = curl_init("https://tonton-tools.com/api/v1/word-counter");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ["X-API-Key: YOUR_API_KEY", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode(["text" => "The quick brown fox."]),
]);
$data = json_decode(curl_exec($ch), true);
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/tools | List all available tools and their parameters. (no key) |
| GET | /api/v1/tools/{slug} | Metadata for one tool. (no key) |
| POST | /api/v1/{slug} | Run a tool with JSON params. (key required) |
| GET | /api/v1/me | Your key info and quota. (key required) |
X-RateLimit-Remaining and X-Daily-Remaining headers. Exceeding a limit returns 429.
Tool reference
25 tools. Each is called with POST /api/v1/{slug}.
Text
word-counter
Word Counter
Count words, characters, sentences, paragraphs and reading time.
text
string
required — Text to analyse
character-counter
Character Counter
Count characters with and without spaces.
text
string
required — Text to count
case-converter
Case Converter
Convert text between cases: upper, lower, title, sentence, camel, snake, kebab.
text
string
required — Text to convert
case
string
required — One of: upper, lower, title, sentence, camel, snake, kebab
text-to-slug
Text to Slug
Convert text into a clean URL slug.
text
string
required — Text to slugify
reverse-text
Reverse Text
Reverse a string character by character.
text
string
required — Text to reverse
remove-duplicate-lines
Remove Duplicate Lines
Remove duplicate lines from text, preserving order.
text
string
required — Text (one item per line)
lorem-ipsum-generator
Lorem Ipsum Generator
Generate placeholder paragraphs of lorem ipsum text.
paragraphs
integer
— Number of paragraphs (1-20)
Encoding
base64-encode
Base64 Encode
Encode text to Base64.
text
string
required — Text to encode
base64-decode
Base64 Decode
Decode Base64 to text.
text
string
required — Base64 string to decode
url-encode
URL Encode
Percent-encode a string for safe use in URLs.
text
string
required — Text to encode
url-decode
URL Decode
Decode a percent-encoded URL string.
text
string
required — Text to decode
html-encode
HTML Encode
Convert special characters to HTML entities.
text
string
required — Text to encode
html-decode
HTML Decode
Convert HTML entities back to characters.
text
string
required — Text to decode
Hashing
md5-generator
MD5 Generator
Generate an MD5 hash (non-security checksums only).
text
string
required — Text to hash
sha1-generator
SHA-1 Generator
Generate a SHA-1 hash.
text
string
required — Text to hash
sha256-generator
SHA-256 Generator
Generate a SHA-256 hash.
text
string
required — Text to hash
sha512-generator
SHA-512 Generator
Generate a SHA-512 hash.
text
string
required — Text to hash
bcrypt-generator
Bcrypt Generator
Generate a salted bcrypt hash, suitable for storing passwords.
text
string
required — Text to hash
rounds
integer
— Cost factor 4-14
Generators
uuid-generator
UUID Generator
Generate one or more random v4 UUIDs.
count
integer
— How many (1-50)
password-generator
Password Generator
Generate a strong random password.
length
integer
— Length 4-128
symbols
boolean
— Include symbols
numbers
boolean
— Include numbers
random-number
Random Number
Generate a cryptographically-random integer in a range.
min
integer
— Minimum
max
integer
— Maximum
Data
json-minify
JSON Minify
Validate and minify a JSON string.
json
string
required — JSON to minify
json-validate
JSON Validator
Check whether a string is valid JSON.
json
string
required — JSON to validate
hex-to-rgb
HEX to RGB
Convert a HEX colour code to RGB.
hex
string
required — HEX colour, e.g. #F5841F
Calculators
percentage-calculator
Percentage Calculator
Calculate X% of Y.
percent
number
required — The percentage
of
number
required — The base number