---
title: Convert Words to Number API
slug: convert-words-to-number-api
url: https://apyhub.com/modernsoftware-pro/service/convert-words-to-number-api
provider: ModernSoftware.pro
categories: [Developer Tools, Standard Data]
tags: [number-conversion, text-parsing, multilingual, language-processing, data-normalization]
auth: api_key
version: 1.0
service_type: sync
endpoints: 2
atoms: 10
mcp: true
---

# Convert Words to Number API

Parse spelled-out numbers in six languages into digits. Supports single or batch conversion for non-negative whole numbers up to 999,999,999,999.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/modernsoftware-pro/convert-words-to-number-api/single/word-to-number` | Converts a single spelled-out numeric phrase in the selected language, and returns the parsed numbe… | 10 |
| POST | `https://api.eu.apyhub.com/modernsoftware-pro/convert-words-to-number-api/bulk/word-to-number` | What it does Converts a batch of spelled-out number phrases into numeric digits. You send an array… | 10 |

## Endpoint reference

### Converts  a spelled-out number phrase in the specified language into numeric digits.

`GET https://api.eu.apyhub.com/modernsoftware-pro/convert-words-to-number-api/single/word-to-number` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `phrase` | query | string | yes |  |
| `language` | query | string | yes | The language the phrase is written in. We currently support 6 languages: German (de), English (en), Spanish (es), French (fr), Italian (it) and Polish (pl). One of: de, en, es, fr, it, pl. |

#### Quickstart

Call this endpoint with your ApyHub API key:

```bash
curl "https://api.eu.apyhub.com/modernsoftware-pro/convert-words-to-number-api/single/word-to-number?phrase=fourteen&language=en" \
  -H 'apy-token: $APY_TOKEN'
```

#### What you'll get back

Returns a JSON object with the `phrase` and `language` passed in the query parameters, and the converted `number` value.

```json
{
  "language": "en",
  "phrase": "fourteen",
  "number": 14
}
```

### Converts a batch of spelled-out number phrases in the specified languages into numeric digits.

`POST https://api.eu.apyhub.com/modernsoftware-pro/convert-words-to-number-api/bulk/word-to-number` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `items` | body | array of object | yes |  |
| `items[].phrase` | body | string | yes |  |
| `items[].language` | body | string | yes | The language the phrase is written in. We currently support 6 languages: German (de), English (en), Spanish (es), French (fr), Italian (it) and Polish (pl). One of: de, en, es, fr, it, pl. |

#### Quickstart

Convert one or more number phrases into their numeric values.

```bash
curl -X POST "https://api.eu.apyhub.com/modernsoftware-pro/convert-words-to-number-api/bulk/word-to-number" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "phrase": "one hundred twenty three",
        "language": "en"
      },
      {
        "phrase": "trois cent vingt et un",
        "language": "fr"
      }
    ]
  }'
```

#### What you'll get back

Returns a JSON object with an `items` array. Each item contains `phrase` and `language`, plus `number` with the parsed non-negative integer value.

```json
{
  "items": [
    {
      "phrase": "one hundred twenty three",
      "language": "en",
      "number": 123
    },
    {
      "phrase": "trois cent vingt et un",
      "language": "fr",
      "number": 321
    }
  ]
}
```

## About

## What it does
Convert Words to Number API,  converts spelled-out number phrases into digits, accepts `phrase` and `language`, and returns the parsed `number` for single or batch requests.

Use it when you need to normalize human-entered numbers from forms, chat logs, invoices, or imported records. It supports German (`de`), English (`en`), Spanish (`es`), French (`fr`), Italian (`it`), and Polish (`pl`), so you can handle multilingual text without building language-specific parsing logic yourself. More languages to be added.

The service only accepts non-negative whole numbers, up to 999,999,999,999. That makes it a good fit for cardinal values like quantities, totals, counts, and other integer fields where text input needs to become structured data.

For bulk conversion, send up to 20 items in the POST endpoint and get back a list of parsed results with the same `phrase` and `language` values alongside each `number`. Bulk conversion costs less than sending the same phrases one-by-one.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/modernsoftware-pro/service/convert-words-to-number-api