AI Data Prep Tier 2 Ready POST /v1/locale-value-parser

Locale-Aware Money, Date & Unit Parser API — Normalize Messy Text Values

Normalize messy EU/US prices, dates, percentages, and measurements into structured JSON. Parse messy multilingual strings like '1.234,50 Ft', '€49,90', '2,5 kg', or '2026. 11. 14.' into normalized ISO dates, currencies, and SI units.

Try It Live in Your Browser · No API Key Required

1. Interactive Sandbox & Sample JSON Output

200 OK · Ready

Editable Request JSON (`POST /v1/locale-value-parser`)

Live 200 OK Response Envelope

{
  "ok": true,
  "data": {
    "money": [
      {
        "raw": "1.234,50 Ft",
        "amount": 1234.5,
        "currency": "HUF",
        "formatted_iso": "1234.50 HUF"
      }
    ],
    "dates": [
      {
        "raw": "2026-11-14",
        "iso_utc": "2026-11-14T00:00:00.000Z",
        "date_only": "2026-11-14",
        "epoch_ms": 1794614400000,
        "kind": "absolute"
      }
    ],
    "units": [
      {
        "raw": "234,50 Ft",
        "category": "length",
        "value": 234.5,
        "unit": "ft",
        "normalized_value": 71.4756,
        "normalized_unit": "m"
      },
      {
        "raw": "2,5 kg",
        "category": "mass",
        "value": 2.5,
        "unit": "kg",
        "normalized_value": 2.5,
        "normalized_unit": "kg"
      }
    ],
    "total_extracted": 4
  },
  "meta": {
    "request_id": "req_lvp_01",
    "ms": 1
  }
}

Get API Key on RapidAPI Get API Key on Zyla Hub Download OpenAPI 3.0.3 Spec

2. Quickstart Code Examples

Full TypeScript & Python SDK →

curl -X POST "https://api.tinplate.dev/v1/locale-value-parser" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -d '{"text":"Total: 1.234,50 Ft due on 2026-11-14 (weight: 2,5 kg)","locale_hint":"HU"}'

import { TinplateClient } from "@tinplate/sdk"; // npm install @tinplate/sdk

const tinplate = new TinplateClient({
  rapidApiKey: process.env.RAPIDAPI_KEY!,
});

const { data, meta } = await tinplate.call("/v1/locale-value-parser", {
  "text": "Total: 1.234,50 Ft due on 2026-11-14 (weight: 2,5 kg)",
  "locale_hint": "HU"
});
console.log(`[${meta.ms} ms]`, data);

import requests

response = requests.post(
    "https://api.tinplate.dev/v1/locale-value-parser",
    headers={
        "Content-Type": "application/json",
        "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
    },
    json={
  "text": "Total: 1.234,50 Ft due on 2026-11-14 (weight: 2,5 kg)",
  "locale_hint": "HU"
}
)
print(response.json())

const response = await fetch("https://api.tinplate.dev/v1/locale-value-parser", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
  },
  body: JSON.stringify({
  "text": "Total: 1.234,50 Ft due on 2026-11-14 (weight: 2,5 kg)",
  "locale_hint": "HU"
}),
});
const result = await response.json();
console.log(result);

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_locale_value_parser",
    "arguments": {
      "text": "Total: 1.234,50 Ft due on 2026-11-14 (weight: 2,5 kg)",
      "locale_hint": "HU"
    }
  }
}

OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (`POST /v1/locale-value-parser`)

Parameter	Type & Constraints	Description
`text`required	`string` minLen: 1, maxLen: 16384	Messy string containing money, dates/times, and/or physical units.
`locale_hint`optional	`"EU" \| "HU" \| "US" \| "CH" \| "GB"` default: "EU"	Disambiguates ambiguous date formats (DD/MM/YYYY vs MM/DD/YYYY) and currency symbols.
`reference_time`optional	`string`	ISO-8601 reference timestamp for relative dates ('tomorrow', 'next Friday 5pm CET').

Response `data` Object Fields (`200 OK`)

Field	Type	Description
`money`	`object[]`	Field 'money'
`dates`	`object[]`	Field 'dates'
`units`	`object[]`	Field 'units'
`total_extracted`	`integer`	Field 'total_extracted'

3. What Text-to-Structured Date, Money & Unit Parser API Detects & Validates

Disambiguates European (1.234,56 / 1 234,56) vs Anglo (1,234.56) thousand and decimal separators
Recognizes 30+ currency symbols and codes (Ft/HUF, €/EUR, $/USD, £/GBP, zł/PLN, Kč/CZK, CHF, JPY)
Normalizes dates (ISO, DD.MM.YYYY, YYYY. MM. DD., US/EU slash dates, and relative offsets)
Converts physical units (mass, length, volume, data size, duration) to canonical SI values

Honest Engineering Boundaries

4. Known Limitations & Test Verification

Release Version: v1.0.7 · Last Verified / Benchmarked: 14 November 2026 · Latency Note: Sub-millisecond figures measure in-Worker V8 compute time (typical client HTTPS network RTT to the nearest Cloudflare PoP is 15–65 ms) · See Full Portfolio Benchmarks & Corpora →

Ambiguous slash dates like 04/05/2026 rely on default_locale (DMY for Europe, MDY for en-US).
Tested v1.0.4 (14 November 2026).

5. Marketplace Plans & Payload Quotas

Plan	Monthly Price	Included Requests	Rate Limit	Max Request Payload	Best For
BASIC	$0.00 / month	500 / month (hard limit)	10 req / min	64 KB	Evaluation, local development & CI smoke tests
PRO	$9.99 / month	15,000 / month	60 req / min	128 KB	Solo developers & production apps
ULTRA	$29.99 / month	100,000 / month	300 req / min	256 KB	Growing SaaS & multi-agent pipelines
MEGA	$79.99 / month	500,000 / month	1,000 req / min	256 KB	High-volume enterprise workloads

Subscribe on RapidAPI Subscribe on Zyla Hub Full Pricing Details

6. Frequently Asked Questions

How does it handle Hungarian Forint and European comma decimals?

It automatically detects thousand-grouping dots/spaces paired with decimal commas (e.g. '1.234,50 Ft' -> 1234.5 HUF).

Can I batch-parse multiple strings in one request?

Yes, pass an array of strings in inputs to parse up to 100 values in a single call.

Does it convert units to base SI?

Yes, e.g. km -> m, kg -> g, GB -> bytes, hours -> seconds.

Zero Payload Logging

7. Data Handling, Privacy & Marketplace Proxy Disclosure

Stateless in-memory parsing; zero payload retention.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled in configuration (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Payloads are processed strictly in volatile V8 memory and never logged or stored by Tinplate.

Marketplace Proxies vs. Direct Bearer Key: Requests sent via RapidAPI or Zyla API Hub pass through those marketplaces' proxy infrastructure (subject to their respective privacy policies). Security-sensitive workloads requiring end-to-end zero-intermediary processing can connect directly to https://api.tinplate.dev using a Direct Bearer Key (Authorization: Bearer <API_KEY>). Read our full Privacy Notice and OpenAPI 3.0.3 JSON Schema.