---
title: "Character Counter"
method: POST
path: "/api/v1/tools/character-counter"
tags: ["tools"]
---

# Character Counter

`POST /api/v1/tools/character-counter`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/character-counter`
- Auth: HTTP bearer

Count the characters, characters without spaces, words, sentences, lines and paragraphs of a text, and rank how often each character appears. The shared counts are defined exactly as the word counter defines them, so the two never disagree about the same paragraph. Use it against a field limit: 280 for a post, 160 for an SMS, 155 for a meta description.

## Request body

- object
  - `text` string
  - `limit` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `characters` integer
    - `charactersNoSpaces` integer
    - `words` integer
    - `sentences` integer
    - `lines` integer
    - `paragraphs` integer
    - `readingTime` object
      - `minutes` integer
      - `seconds` integer
      - `text` string
    - `frequencies` object[]
      - `character` string
      - `count` integer
      - `percent` number

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)