Normalización de direcciones para Sudamérica.
Los nombres de estado y abreviaciones varían por país. Los códigos postales siguen formatos distintos. Normadata parsea estructura, resuelve el estado a ISO 3166-2 y nunca toca un geocoder. La dirección viaja como campo address dentro de un record en /v1/validate/records.
Los geocoders cobran plata que no necesitás gastar
Si tu meta es data de direcciones estructurada — no un pin en un mapa — las APIs de geocoding te cobran por valor que no usás. Los nombres de estado solos ya son un desastre: "buenos aires" vs "Buenos Aires" vs "AR-B", "São Paulo" vs "SP", "Amazonas" existe en BR, CO, PE y VE. Normadata parsea input libre en componentes, normaliza nombres de estado a ISO 3166-2 y desambigua con el country del record.
Estructura sin geocoder
Cómo se normaliza el campo address dentro de un record.
Parseo de componentes
Calle, número, piso, unidad, localidad, estado y país. Sin geocoding, sin lookup externo.
Normalización de estado
Nombre completo, sufijo ISO 3166-2 o alias común resueltos contra la tabla de estados por país.
Diccionario de ciudades
Lookup de top-cities por país. Devuelve un aviso en vez de un falso negativo para inputs long-tail.
Campo de un record
La dirección se manda como campo address de un record; vuelve dentro de fields.address.
Mercados sudamericanos · diccionarios de estado y ciudad
Las tablas de estado abarcan cada mercado sudamericano vivo. El country del record desambigua nombres compartidos (Amazonas, Córdoba, San Juan).
La dirección, como campo de un record
Mandá la dirección en el campo address de un record en /v1/validate/records. Vuelve normalizada dentro de fields.address, con el estado en ISO 3166-2.
$ curl -X POST https://api.normadata.io/v1/validate/records \
-H "X-API-Key: nd_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5" \
-H "Content-Type: application/json" \
-d '{"items":[
{"reference_id":"prov-001","country":"AR","address":"Av. Corrientes 1234, Piso 5, Buenos Aires"}
]}'{
"results": [
{
"reference_id": "prov-001",
"country": "AR",
"fields": {
"address": {
"normalized": "Av. Corrientes 1234, Piso 5",
"components": {
"street": "Av. Corrientes",
"number": "1234",
"floor": "5",
"locality": "Buenos Aires"
},
"state": { "normalized": "Buenos Aires", "iso_3166_2": "AR-B" },
"valid": true
}
},
"consistency": [],
"readiness": {
"payment": { "status": "blocked", "reason": "tax_id is missing" },
"billing": { "status": "blocked", "reason": "tax_id is missing" }
}
}
]
}¿Cómo se compara Normadata?
Comparaciones honestas contra las alternativas que más nos preguntan.
Normadata vs. AbstractAPI
Plataforma global de APIs — y una propuesta más liviana de estructura de direcciones para LATAM.
Normadata vs. Loqate
La librería NPM open-source de facto cubre algunos helpers de address — y dónde se queda corta con estados LATAM.
Normadata vs. Melissa
Plataforma KYC completa que corre después de la validación de formato de dirección, no en lugar de ella.
Estructura de direcciones sin la factura del geocoder
Gratis durante acceso anticipado. Escribinos un email y respondemos en 24 horas.