# Textokit Argentine Street Address Lookup

> Textokit Argentine Street Address Lookup is a paid API for AI agents from tienda.textokit.store, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Looks up Argentine street addresses against the official Georef API, returning candidate matches with street, number, locality, department, province, and coordinates.

## Facts

- Endpoint: POST https://tienda.textokit.store/api/direcciones-ar?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/textokit-argentine-street-address-lookup-7bf6a590
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PAozFRqR8fW3hWKp5Y-BJ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability textokit-argentine-street-address-lookup-7bf6a590 -d '<json body>'
```

Example prompt: Look up the Argentine address 'Av. Corrientes 1234' in the Buenos Aires province (province ID 02) and give me up to 3 candidate matches with their coordinates and official locality details.

## When to prefer this

Use this endpoint when you specifically need to geocode, normalize, or validate a street address located in Argentina using official government data. It is preferable to generic geocoding APIs when Argentine administrative accuracy (department, province, official street naming) is required, or when you need the raw Georef source record and URL for audit purposes. It is not suited for addresses outside Argentina, or when a unique canonical result is required rather than a ranked candidate list.

## Known failure modes

- Address text too short (under 3 characters) — validation error
- Address text too long (over 200 characters) — validation error
- Invalid province ID format (not exactly 2 digits) — validation error
- No matches found for the given address — empty candidates list returned
- Georef upstream API unavailable — service may return an error or empty result
- Overly vague input (locality name only) — may return many unrelated candidates

## How this service works

Servicios para trabajar con textos en Argentina: cartas de reclamo, resúmenes con citas, comparación, traducción y solicitudes. Pagá en pesos con Mercado Pago.

## Output

A list of up to 10 candidate address matches (defaulting to 5), each containing the normalized street name, house number, locality, department, province, geographic coordinates, the raw Georef source record, the source URL, and a read timestamp. No uniqueness guarantee — multiple candidates may be returned for ambiguous inputs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1,
   "description": "Maximum returned candidates, from 1 to 10; defaults to 5."
  },
  "direccion": {
   "type": "string",
   "maxLength": 200,
   "minLength": 3,
   "description": "Address text, from 3 to 200 characters. Locality text alone may not restrict results."
  },
  "provinciaId": {
   "type": "string",
   "pattern": "^[0-9]{2}$",
   "maxLength": 2,
   "minLength": 2,
   "description": "Optional two-digit province identifier, preserving leading zeros. Example: 02 for CABA."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fuente": {
   "url": "https://apis.datos.gob.ar/georef/api/direcciones?direccion=Av.+Corrientes+1234&max=3&provincia=02",
   "consultadoEn": "2026-10-12T10:46:35.433934+00:00"
  },
  "direcciones": [
   {
    "piso": null,
    "calle": {
     "id": "0200701001185",
     "nombre": "AV CORRIENTES",
     "categoria": "AV"
    },
    "altura": {
     "valor": 1234,
     "unidad": null
    },
    "provincia": {
     "id": "02",
     "nombre": "Ciudad Autónoma de Buenos Aires"
    },
    "ubicacion": {
     "lat": -34.60385632930893,
     "lon": -58.38419018127011
    },
    "departamento": {
     "id": "02007",
     "nombre": "Comuna 1"
    },
    "nomenclatura": "AV CORRIENTES 1234, Comuna 1, Ciudad Autónoma de Buenos Aires",
    "calle_cruce_1": {
     "id": null,
     "nombre": null,
     "categoria": null
    },
    "calle_cruce_2": {
     "id": null,
     "nombre": null,
     "categoria": null
    },
    "localidad_censal": {
     "id": "02000010",
     "nombre": "Ciudad Autónoma de Buenos Aires"
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/textokit-argentine-street-address-lookup-7bf6a590/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tienda.textokit.store](https://www.zero.xyz/host/tienda.textokit.store/llms.txt)