{"uid":"cap_b5Bswn6b1U6LCpV1n3DSQ","slug":"agentutility-geocode-bf21a3d8","name":"AgentUtility Geocode","description":"817 pay-per-call APIs for AI agents. Every endpoint is POST /<name> and is payable in USDC over x402 on Base and Solana — no signup, no API key, just pay-per-call. GET https://x402.agentutility.ai/ returns the same catalog as machine-readable JSON.","url":"https://x402.agentutility.ai/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":["address"],"properties":{"limit":{"type":"number","description":"Max results to return. 1-10. Default 5."},"address":{"type":"string","description":"Free-form address, postal code, place name, or POI. Examples: '1600 Amphitheatre Parkway, Mountain View, CA', '10115 Berlin', 'Eiffel Tower'."},"country_codes":{"type":"array","description":"Optional ISO 3166-1 alpha-2 country codes to restrict results, e.g. ['us', 'ca']."}}},"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","properties":{"query":{"type":"string"},"source":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"display_name":{"type":"string"}}}},"best_match":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"},"display_name":{"type":"string"}}},"match_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"query":"Eiffel Tower","source":"OpenStreetMap Nominatim (ODbL, attribution required)","results":[{"latitude":48.8582599,"longitude":2.2945006,"display_name":"Tour Eiffel, Paris, Ile-de-France, France"}],"best_match":{"latitude":48.8582599,"longitude":2.2945006,"display_name":"Tour Eiffel, Paris, Ile-de-France, France"},"match_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NMf8pKXmnqsh4oQpcSSej","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a free-form address, place name, or postal code into geographic coordinates (latitude/longitude) with display name, using OpenStreetMap Nominatim.","exampleAgentPrompt":"Can you geocode '1600 Amphitheatre Parkway, Mountain View, CA' and give me the latitude and longitude?","exampleUseCases":[{"title":"Plotting delivery addresses on a map","prompt":"I have a delivery address — '221B Baker Street, London, UK' — can you get me the latitude and longitude for it so I can plot it on a map?"},{"title":"Resolving landmark coordinates for a travel itinerary","prompt":"What are the GPS coordinates for the Eiffel Tower in Paris? I need the lat/lng to plug into my travel planner."},{"title":"Geocoding a postal code for regional filtering","prompt":"Can you convert the German postal code '10115 Berlin' into coordinates? I want to restrict results to Germany only."}],"resultDescription":"Returns a JSON object with the original query string, the data source attribution (OpenStreetMap Nominatim, ODbL license), an array of up to N result objects each containing latitude, longitude, and display_name, the best_match object (top result), and a match_count integer.","failureModes":["Ambiguous or misspelled address returns zero results (match_count: 0, empty results array)","Very rural or non-standard addresses may return low-quality or unexpected matches","Country code filter too restrictive combined with vague address yields no results","Exceeding limit bounds (outside 1-10) may cause validation errors","Rate limiting or upstream Nominatim unavailability could return 5xx errors"],"whenToPreferThis":"Use this endpoint when you need quick, pay-per-call geocoding without managing API keys or subscriptions. It is ideal for AI agents that occasionally need to resolve addresses or place names to coordinates. The OpenStreetMap Nominatim backend provides broad global coverage. Prefer this over reverse geocoding endpoints when you have a text address and need coordinates, not the other way around.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-06T12:34:26.082Z","isFirstParty":false,"canonicalSlug":"agentutility-geocode-bf21a3d8"}