# beyourspace Geocodificación de Dirección Española (CartoCiudad IGN)

> beyourspace Geocodificación de Dirección Española (CartoCiudad IGN) is a paid API for AI agents from api.beyourspace.es, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-18).

Converts a Spanish postal address into geographic coordinates, municipality, province, and postal code using Spain's CartoCiudad service from the IGN.

## Facts

- Endpoint: POST https://api.beyourspace.es/v1/geocodificar-direccion
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beyourspace-geocodificaci-n-de-direcci-n-espa-ola-cartociudad-ign-f15b4f05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YGTW_IUWdf-KkFGGvYyfF

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 beyourspace-geocodificaci-n-de-direcci-n-espa-ola-cartociudad-ign-f15b4f05 -d '<json body>'
```

Example prompt: Can you geocode this Spanish address for me — Calle Gran Vía 28, Madrid — and return the coordinates, municipality, province, and postal code? Give me up to 3 results.

## When to prefer this

Choose this endpoint when you need to geocode Spanish addresses specifically, leveraging the official Spanish IGN CartoCiudad dataset. It is ideal for Spanish public-sector address data, property tech, logistics, or any application needing municipality, province, and postal code alongside coordinates. Prefer it over generic geocoders (Google Maps, HERE) when you need authoritative Spanish administrative data with open-license attribution (CC BY 4.0) and cost-per-call pricing rather than subscription tiers.

## Known failure modes

- Address not found in CartoCiudad database — returns empty results or low-confidence matches
- Address outside Spain — service only covers Spanish territory
- Malformed or ambiguous address string — may return multiple imprecise candidates
- IGN CartoCiudad upstream service unavailable — results in timeout or error response
- Rate limiting or payment failure due to x402 protocol issues

## How this service works

Endpoints de pago por uso para extraer datos de texto, leer páginas públicas y transformar CSV en JSON normalizado. Sin cuentas ni permanencia, con esquemas documentados y ejemplos ejecutables.

## Output

Returns up to the requested number of matching results, each containing geographic coordinates (latitude/longitude), the normalized municipality name, the province, and the postal code corresponding to the submitted Spanish address. Data is sourced from CartoCiudad (IGN) and provided under CC BY 4.0; results carry no legal validity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limite": {
   "type": "number"
  },
  "direccion": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beyourspace-geocodificaci-n-de-direcci-n-espa-ola-cartociudad-ign-f15b4f05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.beyourspace.es](https://www.zero.xyz/host/api.beyourspace.es/llms.txt)