NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

Vowel Counter API

POST

Measure vowel and consonant distribution across any text.

Vowel Counter analyzes text to count vowels and consonants, providing detailed breakdowns and percentages for linguistic analysis.

Try it — live request, no key required

Request
POSTapi.apiverve.com/v1/vowelcounter
Body
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "vowels": 31,
    "consonants": 58,
    "totalLetters": 89,
    "vowelPercentage": 34.83,
    "consonantPercentage": 65.17,
    "vowelBreakdown": {
      "a": 8,
      "e": 11,
      "i": 3,
      "o": 7,
      "u": 2
    },
    "textLength": 110
  }
}

About the Vowel Counter API

A vowel counter and consonant counter API for letter frequency analysis. Send any text and get back the number of vowels, the number of consonants and the total number of letters, with accented Latin letters such as é and ï counted as the vowel or consonant they are built on. Perfect for linguistic research, readability analysis, and educational applications requiring detailed phonetic character analysis.

Typical uses include phonics and spelling apps that show children how many vowels a word has, word-game scoring and puzzle generation, writing tools that report on letter balance, and research scripts that compare letter frequency across texts or languages without writing their own Unicode handling.

The Free plan returns the vowel, consonant and total letter counts. Paid plans add the vowel percentage and consonant percentage, a per-vowel breakdown showing how many times each of a, e, i, o and u appears, and the full character length of the text including spaces and punctuation.

How it works

Vowel Counter walks text one character at a time. Each character is Unicode-normalized into its base letter plus any accents, the accents are dropped and the result is lowercased. If what remains is a single a, e, i, o or u, the character counts as a vowel and is added to that vowel's slot in vowelBreakdown. So "É", "ï" and "ô" count as e, i and o, and uppercase and lowercase are counted together.

A character whose base letter is one of the other 21 Latin letters (b to z, including y and w in every position) counts as a consonant, as do the Latin consonants that do not decompose (ß, þ, ð, ł, đ, ħ, ŋ). Every other letter, such as ø, æ and letters of non-Latin scripts (Cyrillic, Greek, Arabic, CJK), is neither an English vowel nor a consonant and is counted in otherLetters instead, so "Привет" returns 0 vowels, 0 consonants and 6 otherLetters. Digits, spaces, punctuation and emoji are ignored by every count.

totalLetters is vowels plus consonants; it does not include otherLetters. vowelPercentage and consonantPercentage are shares of totalLetters, not of the whole text, rounded to two decimals; they are 0 when the text contains no letters. textLength is the length of the input in JavaScript string units, which includes spaces, punctuation and line breaks and counts most emoji as two.

On the Free plan the percentages, the five per-vowel counts inside vowelBreakdown and textLength are null; vowels, consonants and totalLetters are returned on every plan.

What people use it for

Linguistic Analysis
Analyze vowel patterns and distributions in text for linguistic research
Readability Testing
Assess text complexity based on vowel-consonant ratios
Educational Tools
Create exercises for teaching phonetics and letter recognition
Text Statistics
Generate detailed character frequency reports for writing analysis

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use Vowel Counter

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the Vowel Counter API.

Read the docs →
What is the maximum text length I can analyze in a single request?
You can submit passages up to 50,000 characters in a single call. This accommodates entire articles, essays, or book chapters in one request.
Do I get individual vowel breakdowns and percentages on the Free plan?
No. The Free plan provides basic totals for vowels, consonants, and total letters. Letter-by-letter counts for a, e, i, o, and u, percentage calculations, and total text length require any paid plan, starting with Starter.
How many text analyses does the Free plan cover?
The Free plan covers 200 analyses each month at 1 credit per call. Upgrading to Starter provides 200,000 credits each month, enough for 200,000 analyses, which works out to about $0.15 per 1,000 calls.
Does the API treat the letter Y as a vowel or a consonant?
The API counts standard English vowels: a, e, i, o, and u, after removing accents (so é counts as e). The other Latin letters, including y, are consonants. Letters from other scripts, such as Cyrillic, Greek or CJK, are neither and are reported separately in otherLetters.
How does the API handle punctuation, spaces, and numbers?
Non-alphabetic characters are excluded from vowel, consonant, and total letter counts. However, overall character length, available on paid plans, counts every character in the string including whitespace and punctuation.

Ready to build with Vowel Counter? Start with 200 free credits — one key unlocks all 406+ APIs.

Explore the catalog

406+ APIs on the same key and the same response shape.

Browse all APIs