POST /v1/nlp/lemmatize
Lemmatiser
'Running' becomes 'run', so counts group the way a reader would expect.
Reduce words to their base form now No key, no code — 3 credits either way.
curl -X POST "$DOATHING_API/v1/nlp/lemmatize" \
-H "x-api-key: $DOATHING_KEY" \
-H "content-type: application/json" \
-d '{"text": "She was running faster than the other runners."}'
'Running' becomes 'run', so counts group the way a reader would expect.
Reduce tokens to WordNet lemmas or Porter stems, optionally part-of-speech aware.
Input
Send either a text string or a file object. A file is decoded as UTF-8 and must be one of text/plain, text/markdown, text/html, text/csv.
Response
The result carries your remaining balance alongside it, so you can track spend without a second call.
{
"text": "she be run faster than the other runner",
"method": "wordnet",
"changed": 4,
"request_id": "37f01edb-0163-42a1-ac51-0acaef979800",
"credits_remaining": 96
}
Cost
3 credits per call, whether it is run from the site or from the API — the credential differs, the price does not. A new account starts with 20 credits.
A rejected request still costs a credit: the authorizer decrements before the tool validates. A call rejected for a missing or invalid key is free.
Parameters
Generated from the endpoint’s own validation, so this is exactly what it accepts. A body field goes at the top level; an option goes inside options.
| Name | In | Type | Default | Notes |
|---|---|---|---|---|
| method | options | string | "wordnet" | wordnet for dictionary lemmas, porter for stems. one of wordnet, porter |
| pos_aware | options | boolean | true | Tag first, so 'running' lemmatises to 'run' rather than staying a noun. |
| strip_punctuation | options | boolean | false |