Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
AI Data Prep Tier 2 All-Access

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.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/locale-value-parserinput
200 OK sample / live responsejson
{
  "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"
      }
    ],
    "numbers": [
      {
        "raw": "1.234,50",
        "value": 1234.5,
        "locale_hint": "HU"
      },
      {
        "raw": "2,5",
        "value": 2.5,
        "locale_hint": "HU"
      }
    ],
    "total_extracted": 6
  },
  "meta": {
    "request_id": "req_lvp_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/locale-value-parser" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_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";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_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",
        "Authorization": "Bearer YOUR_TINPLATE_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",
    "Authorization": "Bearer YOUR_TINPLATE_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)

ParameterType & ConstraintsDescription
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)

FieldTypeDescription
money object[] Field 'money'
dates object[] Field 'dates'
units object[] Field 'units'
numbers object[] Field 'numbers'
total_extracted integer Field 'total_extracted'
warnings string[] Field 'warnings'

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

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • 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).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

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

Data Handling, Privacy & Proxy Disclosure

Stateless in-memory parsing; zero payload retention.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/invoice-validator Tier 1

Invoice & EU EN 16931 / Peppol Validator API

Audit extracted invoices for line-item math errors, VAT mismatches, and Peppol compliance.

POST /v1/hu-business-validator Compliance & Business

Hungarian Business Document & NAV Validator API

Validate Hungarian adószám, cégjegyzékszám, GIRO bank accounts, and NAV invoice rules.

POST /v1/json-heal Live

Broken JSON & LLM Output Healer API

Repair malformed or truncated LLM JSON outputs into valid, schema-checked JSON in 1 ms.