---
title: "Word Frequency Counter"
method: POST
path: "/api/v1/tools/word-frequency-counter"
tags: ["tools"]
---

# Word Frequency Counter

`POST /api/v1/tools/word-frequency-counter`

## Request

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

Count how often each word occurs in a text and return a ranked table, most frequent first, with counts and percentages. Can ignore case, skip short words and drop common stop words.

## Request body

- object
  - `text` string
  - `ignoreCase` boolean
  - `minLength` integer
  - `excludeStopWords` boolean
  - `limit` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `words` object[]
      - `rank` integer
      - `word` string
      - `count` integer
      - `percent` number
    - `totalWords` integer
    - `uniqueWords` integer

## 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)