{"uid":"cap_lbiGi1rNBTmxT3_52I56a","slug":"ishob-offline-geocoding-853c98b3","name":"ISHOB Offline Geocoding","description":"Offline geocoding (GeoNames + DB-IP, CC BY 4.0): exactly one of ip (IPv4/IPv6 -> country/region/city/lat,lon), q (place name, e.g. 'Springfield, IL, US', optional country filter), postcode (+country), or lat+lon (reverse: nearest places). City/place level; no street addresses.","url":"https://api.ishob.com/v1/geocode?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","maxLength":200,"description":"Place name; qualifiers after commas (region, country)"},"ip":{"type":"string","description":"Public IPv4/IPv6 address"},"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180},"limit":{"type":"integer","default":5,"maximum":10,"minimum":1},"country":{"type":"string","maxLength":64,"description":"ISO alpha-2/3 or English name"},"postcode":{"type":"string","maxLength":16}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"mode":"search","results":[{"lat":48.85341,"lon":2.3488,"name":"Paris","admin1":"Île-de-France","country_code":"FR"}],"attribution":"Place data from GeoNames ..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Y3deDaYaFOP0yr0Rdo4GQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves IP addresses, place names, postcodes, or lat/lon coordinates to geographic data (country, region, city, coordinates) using offline GeoNames + DB-IP datasets.","exampleAgentPrompt":"What city and country is the IP address 203.0.113.42 located in, and what are its approximate coordinates?","exampleUseCases":[{"title":"IP address geolocation for analytics","prompt":"I have the IP address 198.51.100.77 from a user signup — can you tell me what country, region, and city it maps to, along with the coordinates?"},{"title":"Place name to coordinates lookup","prompt":"I need the latitude and longitude for Springfield, IL, US — can you geocode that for me and return up to 3 matching results?"},{"title":"Reverse geocoding a lat/lon point","prompt":"Given coordinates lat 48.8534, lon 2.3488, what is the nearest city and region?"}],"resultDescription":"Returns a JSON object with a 'mode' field indicating the geocoding type (search, ip, reverse), a 'results' array of matching places each containing name, admin1 (region), country_code, lat, and lon, and an attribution string crediting GeoNames and DB-IP.","failureModes":["No results found for an obscure or misspelled place name — returns empty results array","Private or reserved IP addresses (e.g. 192.168.x.x) cannot be geolocated — may return error or empty results","Street-level address queries will not resolve — only city/place level supported","Invalid lat/lon values outside -90/90 or -180/180 ranges rejected by schema","Missing required query parameter (none of ip, q, postcode, lat+lon provided) returns error","Multiple conflicting query modes supplied simultaneously may return error"],"whenToPreferThis":"Choose this endpoint when you need fast, offline city/region-level geocoding without street address precision — ideal for IP geolocation, place name resolution, postcode lookup, or reverse geocoding at city granularity. Prefer it over street-level geocoding APIs when privacy, latency, or cost matter and city-level accuracy suffices. The offline nature means no rate limits from upstream providers and consistent sub-100ms responses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:46:39.486Z","isFirstParty":false,"canonicalSlug":"ishob-offline-geocoding-853c98b3"}