{"uid":"cap_v5fABXd8bmVFUfIE3wvtg","slug":"agentsvc-io-geocoding-api-64653409","name":"agentsvc.io Geocoding API","description":"86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.","url":"https://agentsvc.io/api/v1/proxy/geocode?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":[],"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","data"],"properties":{"data":{"type":"object","required":["mode","results"],"properties":{"mode":{"enum":["forward","reverse"],"type":"string"},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"type":{"enum":["city","postcode"],"type":"string"},"address":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"postcode":{"type":["string","null"]},"country_code":{"type":"string"}}},"timezone":{"type":["string","null"]},"precision":{"enum":["locality","postal_code"],"type":"string"},"population":{"type":["integer","null"]},"distance_km":{"type":"number"},"geonames_id":{"type":["integer","null"]},"display_name":{"type":"string"}}}},"attribution":{"type":"string"},"ignored_parts":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"mode":"forward","source":"GeoNames","results":[{"lat":48.85341,"lon":2.3488,"type":"city","address":{"city":"Paris","state":"Île-de-France","country":"France","postcode":null,"country_code":"fr"},"timezone":"Europe/Paris","precision":"locality","population":2138551,"geonames_id":2988507,"display_name":"Paris, Île-de-France, France"}],"attribution":"Place data from GeoNames (geonames.org), CC BY 4.0","ignored_parts":["Avenue Anatole France 5"]},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.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_0OO1Iz9YgHRdwAgDPKeql","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts addresses to coordinates (forward geocoding) or coordinates to addresses (reverse geocoding) using OpenStreetMap Nominatim","exampleAgentPrompt":"Can you geocode '1600 Pennsylvania Avenue NW, Washington DC' and give me its latitude and longitude?","exampleUseCases":[{"title":"Enrich delivery addresses with coordinates","prompt":"I have a list of customer shipping addresses — can you convert '221B Baker Street, London, UK' to GPS coordinates so I can plot it on a map?"},{"title":"Reverse geocode a GPS ping","prompt":"I have a GPS coordinate — 48.8584° N, 2.2945° E — can you look up what address or place that corresponds to?"},{"title":"Resolve landmark name to location","prompt":"What are the exact latitude and longitude coordinates of the Colosseum in Rome, Italy?"}],"resultDescription":"Returns a JSON object with a mode field ('forward' or 'reverse'), a source field ('OpenStreetMap Nominatim'), and a results array. Each result contains lat/lon coordinates, OSM place type, OSM element type (node/way/relation), place_id, display_name (full formatted address string), and a structured address object with components like road, city, state, postcode, country, country_code (ISO 3166-1 alpha-2).","failureModes":["Address not found — results array is empty when the address cannot be resolved","Ambiguous address — multiple results returned for a vague or non-unique place name","Coordinates out of range — invalid lat/lon values cause an error response","Missing required body fields — omitting address or coordinates returns a validation error","Rate limiting or upstream Nominatim outage — proxy may return a 5xx error"],"whenToPreferThis":"Use this endpoint when you need a quick, pay-per-call geocoding solution with no API key setup, backed by OpenStreetMap Nominatim. Ideal for agents that need to convert addresses to coordinates or coordinates to addresses on demand without committing to a subscription. Prefer over Google Maps or HERE geocoding when open data licensing (OSM) is acceptable and cost-per-call via USDC micropayment is preferred over monthly billing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:41:53.489Z","isFirstParty":false,"canonicalSlug":"agentsvc-io-geocoding-api-64653409"}