{"slug":"agentsvc-io-api-v1-proxy-geocode-d3d255","title":"Geocoding and reverse geocoding from GeoNames","host":"agentsvc.io","method":"POST","resource":"https://agentsvc.io/api/v1/proxy/geocode","category":"code","description":"Geocoding and reverse geocoding from GeoNames: city, town or postal code to lat/lon, and lat/lon to the nearest place and postal code. Covers 170,000 places with 1000+ inhabitants and 1.8 million postal codes worldwide, answered from our own database in milliseconds. Not street level: house numbers ","price_listed":0.003,"price_asked":0.003,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":889,"reported_calls_30d":12,"reported_payers_30d":3,"networks":["eip155:137","eip155:42161","eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"address":"Brandenburger Tor, Berlin"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{},"required":[]},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"properties":{"attribution":{"type":"string"},"ignored_parts":{"items":{"type":"string"},"type":"array"},"mode":{"enum":["forward","reverse"],"type":"string"},"results":{"items":{"properties":{"address":{"properties":{"city":{"type":"string"},"country":{"type":"string"},"country_code":{"type":"string"},"postcode":{"type":["string","null"]},"state":{"type":"string"}},"type":"object"},"display_name":{"type":"string"},"distance_km":{"type":"number"},"geonames_id":{"type":["integer","null"]},"lat":{"type":"number"},"lon":{"type":"number"},"population":{"type":["integer","null"]},"precision":{"enum":["locality","postal_code"],"type":"string"},"timezone":{"type":["string","null"]},"type":{"enum":["city","postcode"],"type":"string"}},"type":"object"},"type":"array"},"source":{"type":"string"}},"required":["mode","results"],"type":"object"},"success":{"type":"boolean"}},"required":["success","data"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-10","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.003,"price_match":true,"latency_ms":889,"error":null}],"description_full":"Geocoding and reverse geocoding from GeoNames: city, town or postal code to lat/lon, and lat/lon to the nearest place and postal code. Covers 170,000 places with 1000+ inhabitants and 1.8 million postal codes worldwide, answered from our own database in milliseconds. Not street level: house numbers and streets are skipped and reported in ignored_parts. Provide address (e.g. 'Paris, Texas', '10115 Berlin') or lat + lon.","last_updated":"2026-10-10T09:08:10.14Z","schemes":["exact"]}