Skip to content
POST AI agent ready /v1/text/stats

Character Count API - Words, Sentences & Reading Time

Analyzes a text string and returns word count, character count (with and without spaces), sentence count, paragraph count, and estimated reading time in minutes. Based on an average reading speed of 238 words per minute.

Parameters

stringrequired

The text to analyze.

Code examples

curl -X POST https://api.botoi.com/v1/text/stats \
  -H "Content-Type: application/json" \
  -d '{"text":"Botoi provides 150+ developer APIs. Each endpoint is free to try without signup."}'

When to use this API

Show reading time on blog posts

Calculate and display "X min read" badges on article listings so readers know the time commitment before clicking.

Enforce text length limits in a CMS

Validate that product descriptions, meta descriptions, or bio fields stay within word or character count limits.

Analyze content density for SEO

Count words and sentences per section to ensure content meets minimum length thresholds for search ranking.

Frequently asked questions

What reading speed is used for the reading time estimate?
The estimate uses 238 words per minute, the average adult reading speed based on published research.
Does the character count include whitespace?
The response includes both characters (with spaces) and charactersNoSpaces (without spaces) so you can pick the metric you need.
How are sentences detected?
Sentences are split on period, exclamation mark, and question mark followed by a space or end of string. Abbreviations like "e.g." are handled to avoid false splits.
Does this support non-English text?
Yes. Character and word counting works for any UTF-8 text. Reading time estimates are calibrated for English but provide a reasonable approximation for other languages.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.