API para normalizar y geocodificar direcciones argentinas

Mandale la dirección como la escribió el usuario (“av corrientes 1234 caba”, “san martín y belgrano, rosario”) y la API la compara con el callejero oficial: te devuelve la dirección normalizada, la localidad, el departamento o partido, la provincia y la latitud y longitud, con varios candidatos si es ambigua.

Cuesta 2 créditos por consulta (entre USD 0,04 y USD 0,06, según el pack). La key de prueba es gratis, sin registro ni tarjeta, y trae 50 créditos. La misma key sirve en las tres APIs de la suite (AR Tools, Índices AR y Direcciones AR), con un solo saldo.

Para qué la usan

Empezá en un minuto

1. Pedí una key de prueba

curl -X POST https://direcciones-ar-api-103907796853.us-east1.run.app/v1/keys -H 'content-type: application/json' -d '{"name": "mi-sistema"}'

Devuelve key (empieza con ak_, guardala: no se vuelve a mostrar), key_id y los créditos.

2. Llamá a normalizar_direccion

curl -X POST https://direcciones-ar-api-103907796853.us-east1.run.app/v1/tools/normalizar_direccion \
  -H 'Authorization: Bearer ak_...' \
  -H 'content-type: application/json' \
  -d '{"direccion":"Av. Corrientes 1234","provincia":"CABA"}'

Respuesta (abreviada)

{
  "result": {
    "consulta": "Av. Corrientes 1234",
    "cantidad": 1,
    "ambigua": false,
    "mejor": {
      "direccion_normalizada": "AV CORRIENTES 1234",
      "altura": 1234,
      "localidad": "Ciudad Autónoma de Buenos Aires",
      "departamento": "Comuna 1",
      "provincia": "Ciudad Autónoma de Buenos Aires",
      "provincia_id": "02",
      "lat": -34.60385632930893,
      "lon": -58.38419018127011
    },
    "fuente": "georef (INDEC/IGN)"
  },
  "credits": {
    "cost": 2,
    "balance": 48
  }
}

Python

import requests

r = requests.post(
    "https://direcciones-ar-api-103907796853.us-east1.run.app/v1/tools/normalizar_direccion",
    headers={"Authorization": "Bearer ak_..."},
    json={ "direccion": "Av. Corrientes 1234", "provincia": "CABA" },
    timeout=30,
)
print(r.json()["result"])

JavaScript

const r = await fetch("https://direcciones-ar-api-103907796853.us-east1.run.app/v1/tools/normalizar_direccion", {
  method: "POST",
  headers: { Authorization: "Bearer ak_...", "content-type": "application/json" },
  body: JSON.stringify({"direccion":"Av. Corrientes 1234","provincia":"CABA"}),
});
const { result, credits } = await r.json();

Agentes de IA (MCP)

La misma tool está en el servidor MCP https://direcciones-ar-api-103907796853.us-east1.run.app/mcp, junto con las demás de Direcciones AR (por ejemplo ubicacion).

claude mcp add --transport http direcciones-ar https://direcciones-ar-api-103907796853.us-east1.run.app/mcp --header "Authorization: Bearer ak_..."
{
  "mcpServers": {
    "direcciones-ar": {
      "url": "https://direcciones-ar-api-103907796853.us-east1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer ak_..."
      }
    }
  }
}

n8n

Usá un nodo HTTP Request: método POST, URL https://direcciones-ar-api-103907796853.us-east1.run.app/v1/tools/normalizar_direccion, header Authorization con el valor Bearer ak_... (mejor como credencial de tipo Header Auth) y, en Body, JSON con {"direccion":"Av. Corrientes 1234","provincia":"CABA"}. El resultado queda en {{$json.result}}. También podés usar el nodo MCP Client con la URL https://direcciones-ar-api-103907796853.us-east1.run.app/mcp.

Google Sheets

En Extensiones → Apps Script, pegá esta función. Guardá la key en Configuración del proyecto → Propiedades de la secuencia de comandos con el nombre AR_API_KEY, así no queda en el código. Después usala en una celda: =NORMALIZAR_DIRECCION(A2; "CABA"). Cada celda hace una consulta y gasta créditos.

function NORMALIZAR_DIRECCION(direccion, provincia) {
  const key = PropertiesService.getScriptProperties().getProperty("AR_API_KEY");
  const r = UrlFetchApp.fetch("https://direcciones-ar-api-103907796853.us-east1.run.app/v1/tools/normalizar_direccion", {
    method: "post",
    contentType: "application/json",
    headers: { Authorization: "Bearer " + key },
    payload: JSON.stringify({ direccion: direccion, provincia: provincia }),
  });
  return JSON.parse(r.getContentText()).result.mejor.direccion_normalizada;
}

Preguntas frecuentes

¿De dónde salen los datos?

Del servicio georef del Gobierno argentino, con el callejero del INDEC y el IGN.

¿Qué pasa si la dirección no existe?

cantidad viene en 0. Si hay varias coincidencias, ambigua es true y vienen todos los candidatos.

¿Y de coordenadas a dirección?

Con la tool ubicacion pasás latitud y longitud y te devuelve provincia, departamento y municipio.

¿Qué pasa cuando se terminan los créditos?

La API responde 402 con un checkout_url para recargar. Los packs se pagan una sola vez, sin suscripción, y los créditos no vencen. Ver precios.

Más

Otras APIs de datos argentinos

Privacidad