Skip to content
T
Tools.Town
Free Online Tools for Everyone

Character Counter API

Real-time character, word, line, sentence count plus Twitter / SMS / meta-description limit warnings. Grapheme-aware (emoji counts as 1).

Category: Text Tools Endpoint: /v1/text/character-count 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/character-count

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

Example Request

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

Example Response 200 OK

application/json
{
  "success": true,
  "data": {
    "characters": "0",
    "charactersNoSpaces": "0",
    "charactersNoSpacesOnly": "0",
    "graphemes": "0",
    "words": "0",
    "lines": "0",
    "sentences": "0",
    "paragraphs": "0",
    "readingTimeSeconds": "0",
    "speakingTimeSeconds": "0",
    "twitterRemaining": "0",
    "smsRemaining": "0",
    "metaDescriptionRemaining": "0",
    "titleRemaining": "0"
  }
}

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