{"uid":"cap_UxhqEa0f44k8708cPtbBc","slug":"spanish-municipality-lookup-by-name-cartociudad-ign-ae68d643","name":"Spanish Municipality Lookup by Name (CartoCiudad/IGN)","description":"Find a Spanish municipality or town by name: INE code, province, region and coordinates, with alternatives when several match. Official CartoCiudad (IGN) data.","url":"https://api.vextorium.com/municipio-es-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["nombre"],"properties":{"nombre":{"type":"string"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"fuente":{"type":["string","null"]},"consulta":{"type":["string","null"]},"resultados":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"tipo":{"type":["null","string"]},"nombre":{"type":["null","string"]},"comunidad":{"type":["null","string"]},"provincia":{"type":["null","string"]},"codigo_ine":{"type":["null","string"]}}}}}}}}}},"responseSchema":{"type":"json","example":{"fuente":"CartoCiudad (IGN/CNIG, CC BY 4.0)","consulta":"Zarautz","resultados":[{"lat":43.28416905310724,"lon":-2.16668338665575,"tipo":"poblacion","nombre":"Zarautz, Zarautz","comunidad":"País Vasco/Euskadi","provincia":"Gipuzkoa","codigo_ine":"20079"},{"lat":43.23928748211347,"lon":-2.733328132386681,"tipo":"poblacion","nombre":"Zarautz baserria / Caserío Zarautz, Zarautz baserria / Caserío Zarautz (Amorebieta-Etxano)","comunidad":"País Vasco/Euskadi","provincia":"Bizkaia","codigo_ine":"48003"},{"lat":43.27407366849084,"lon":-2.169209291542749,"tipo":"Municipio","nombre":"Zarautz, Gipuzkoa","comunidad":"País Vasco/Euskadi","provincia":"Gipuzkoa","codigo_ine":"20079"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mD8aLqb2epIhnVfX8XZN-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finds Spanish municipalities or towns by name and returns INE code, province, autonomous community, and geographic coordinates using official CartoCiudad (IGN) data.","exampleAgentPrompt":"Can you look up the official data for the Spanish municipality 'Zarautz' — I need its INE code, province, autonomous community, and coordinates?","exampleUseCases":[{"title":"Geocoding a Spanish town for mapping","prompt":"I need the latitude and longitude of Alcalá de Henares so I can pin it on a map — can you look it up using official Spanish geographic data?"},{"title":"Resolving INE code for administrative forms","prompt":"What's the official INE code for the municipality of Ronda in Málaga? I need it to fill in a Spanish government form."},{"title":"Disambiguating duplicate town names","prompt":"There's a town called 'Vilanova' in Spain — can you find all the municipalities with that name and tell me their provinces and autonomous communities?"}],"resultDescription":"Returns a JSON object with the query string, data source attribution (CartoCiudad/IGN, CC BY 4.0), and an array of matching results. Each result includes the place name (official), type (e.g. Municipio, población), province, autonomous community, INE code, and decimal latitude/longitude coordinates. Multiple results are returned when the name matches more than one location.","failureModes":["Name not found in CartoCiudad database — results array may be empty","Ambiguous name returns multiple unrelated municipalities requiring manual disambiguation","Misspelled or accented name may fail to match — input must be reasonably close to the official name","Non-Spanish municipality names will not be found","Network or payment errors may prevent the request from completing"],"whenToPreferThis":"Use this endpoint when you need official Spanish municipal data — INE codes, administrative hierarchy (province and autonomous community), and geographic coordinates — sourced from the authoritative CartoCiudad (IGN/CNIG) dataset. Prefer this over generic geocoders when you specifically need the INE code or need to verify Spain's official administrative classification. It also handles name disambiguation by returning multiple candidates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:41:30.989Z","isFirstParty":false,"canonicalSlug":"spanish-municipality-lookup-by-name-cartociudad-ign-ae68d643"}