API de adrese pentru România

Orice adresă din România,corectă din prima.

Autocomplete, verificare și coduri poștale, printr-un singur API. Construit pe datele Poșta Română, SIRUTA și OpenStreetMap — cu acoperire până în mediul rural, normalizare de diacritice și precizie până la codul poștal. Răspuns sub 150 ms.

Ia o cheie APIVezi cum merge
Fără card1.000 de cereri gratuite / lunăDate găzduite în UE
Demo live

Scrie o adresă. Oricât de strâmbă.

Posty o normalizează, o corectează și îți spune cât de sigur e răspunsul. În timp real.

Încearcă acum

Tastează pentru a vedea sugestii

Încearcă cu adresa ta Toate exemplele în docs
Problema

Adresele românești strică software-ul.

Nu pentru că developerii greșesc, ci pentru că datele sunt un câmp minat. Posty se ocupă de tot ce e mai jos, ca tu să nu o faci.

01

Diacritice care nu se potrivesc.

„ş” cu sedilă vs „ș” cu virgulă, „Bucureşti” vs „București”. Două șiruri diferite pentru aceeași localitate.

02

Abrevieri haotice.

Str., Bd., Șos., Aleea, Calea, B-dul. Fiecare client le scrie altfel.

03

Coduri poștale și localități rurale.

Sat, comună, județ — cu precizie până la codul poștal. Acolo unde alte API-uri se opresc la oraș.

04

Numere de casă freeform.

„nr. 12-18”, „bl. 54/2D”. Imposibil de validat naiv.

Capabilități

Trei lucruri, un singur API.

Autocomplete

Sugestii de adrese pe măsură ce userul scrie. Toleranță la greșeli de scriere și diacritice, sub 150 ms.

GET /v1/addresses/autocomplete

Verificare

Trimite o adresă structurată sau freeform. Primești un verdict, corecții pe fiecare câmp, un scor de încredere și, unde există, coordonate.

POST /v1/addresses/verify

Cod poștal

Caută orice cod poștal din 6 cifre și primești localitatea, județul și strada, unde se aplică.

GET /v1/postal-codes/
Răspuns

Un răspuns pe care îl poți citi.

Cerere
curl -X POST https://api.posty.ro/v1/addresses/verify \
  -H "Authorization: Bearer psk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "freeform": "Str. Mihai Vitezu 12, cluj" }'
Răspuns · 200 OK
{
  "verdict": "corrected",
  "confidence": 0.92,
  "address": {
    "street": "Strada Mihai Viteazu",
    "house_number": "12",
    "locality": "Cluj-Napoca",
    "county": "Cluj",
    "county_code": "CJ",
    "postal_code": "400151"
  },
  "corrections": [
    {
      "field": "street_name",
      "from": "Mihai Vitezu",
      "to": "Mihai Viteazu",
      "reason": "diacritic"
    },
    {
      "field": "street_type",
      "from": "Str.",
      "to": "Strada",
      "reason": "expansion"
    },
    {
      "field": "locality",
      "from": "cluj",
      "to": "Cluj-Napoca",
      "reason": "casing"
    }
  ],
  "geolocation": {
    "lat": 46.7712,
    "lng": 23.597,
    "source": "osm"
  },
  "metadata": {
    "source_versions": {
      "baseline": "posta-romana-2013-10",
      "osm": "2026-05"
    }
  }
}
Quickstart

De la zero la verificat, în câteva linii.

Ia o cheie, fă primul apel, gata. Tabs pentru curl, JavaScript, Go și Python.

import { Posty } from "@posty/sdk";

const posty = new Posty(process.env.POSTY_KEY);

const res = await posty.verify({
  freeform: "Str. Mihai Vitezu 12, cluj"
});

console.log(res.verdict);      // "corrected"
console.log(res.address.postal_code); // "400151"
Use cases

Unde își dă Posty măsura.

Checkout e-commerce

Mai puține livrări eșuate, mai puține retururi. Adresa e validă înainte să apeși „Plasează comanda”.

Curierii te iubesc.

Logistică & last-mile

Adrese normalizate și geolocalizate, gata de rutare.

Dispecerii te iubesc.

Facturare & e-Factura

Date de adresă curate pentru facturi corecte din prima.

Contabilitatea te iubește.

Fintech & KYC

Verificare de adresă la onboarding, fără frecare.

Compliance te iubește.

Sector public & utilități

Adrese consistente la scară națională.

Statul te iubește (da, se poate).
De ce Posty

Patru lucruri pe care le facem ca lumea.

01

Acoperire până în mediul rural.

Sat, comună, județ — nu doar marile orașe. Structura administrativă a României, tratată nativ.

02

Diacritice normalizate.

„ş” cu sedilă și „ș” cu virgulă, majuscule, prescurtări — totul ajunge la aceeași formă canonică.

03

Precizie până la codul poștal.

Cod poștal, stradă și interval de numere reconciliate, nu doar localitatea.

04

Latență mică.

Sub 150 ms la autocomplete, ca să nu blocheze checkout-ul.

42
județe
11.000+
localități
22.000+
străzi
38.000+
coduri poștale
Sub 150 ms Găzduit în UE Conform GDPR
Prețuri

Prețuri previzibile. Începi gratis.

Abonament lunar, fără costuri ascunse. Treci de la Free la plătit când ai nevoie, nu invers.

Free
€0/lună
1,000 cereri/lună · 5 rps
  • Autocomplete + Verificare
  • Cod poștal lookup
  • Rate-limit headers
  • Suport pe comunitate
Începe gratis
Starter
€29/lună
50,000 cereri/lună · 20 rps
  • Tot din Free
  • Coordonate (geocoding)
  • Suport pe email
  • 99.9% uptime SLA
Alege planul
Popular
Growth
€99/lună
500,000 cereri/lună · 50 rps
  • Tot din Starter
  • Batch verify
  • Webhooks
  • Suport prioritar
Alege planul
Enterprise
Contract
Volum
  • Volum custom
  • On-prem / VPC
  • SSO + audit logs
  • SLA dedicat
Contactează-ne
Vezi toate planurile
Întrebări

Întrebări frecvente.

Adrese curate, într-o după-amiază.

Cheie API gratuită, 1.000 de cereri pe lună, fără card.

Începe gratisCitește docs