{"uid":"cap_M3EcZH0Gd5dANYLbp2V9i","slug":"openverbs-forward-geocoding-00380e07","name":"OpenVerbs Forward Geocoding","description":"Convert a free-form address or place name into ranked coordinates with a structured, normalized address. Optionally bias by country and language.","url":"https://geocode.openverbs.com/v1/forward","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":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":512,"minLength":1,"description":"Free-form address or place name."},"lang":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Preferred result language (2-letter code)."},"limit":{"type":"integer","maximum":20,"minimum":1,"description":"Maximum results to return."},"country":{"type":"string","pattern":"^[A-Za-z]{2}(,[A-Za-z]{2})*$","description":"Restrict to one or more ISO 3166-1 alpha-2 country codes (comma-separated)."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a3U0GkJhF7rPosPT7iYsw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a free-form address or place name into ranked geographic coordinates with a structured, normalized address.","exampleAgentPrompt":"Can you geocode '1600 Amphitheatre Parkway, Mountain View, CA' and give me the coordinates and a normalized address? Limit results to 3 and bias toward the US.","exampleUseCases":[{"title":"Mapping customer delivery addresses","prompt":"I have a delivery address — '221B Baker Street, London, UK' — can you convert it to coordinates for mapping? Restrict results to GB and return up to 5 matches."},{"title":"Locating a business by name","prompt":"What are the GPS coordinates for 'Eiffel Tower, Paris'? I need the latitude and longitude along with a normalized address, preferably with results in French."},{"title":"Validating and normalizing user input","prompt":"A user typed '42 wallaby way sydney' as their address — can you geocode that, limit to 1 result, and give me back a clean, structured version of the address with coordinates?"}],"resultDescription":"An ordered list of geocoding results, each containing ranked latitude/longitude coordinate pairs and a structured, normalized representation of the matched address, filtered and localized according to any country or language preferences provided.","failureModes":["Empty or nonsensical query string returns no results or low-confidence matches","Country code filter too restrictive — valid address excluded because it doesn't match specified country","Invalid 2-letter country or language code returns a validation error","Query exceeds 512 characters and is rejected","Service returns ambiguous multiple results when the address is not specific enough","Network or upstream geocoding provider timeout"],"whenToPreferThis":"Choose this endpoint when you need to resolve a free-form, human-typed address or place name into machine-usable coordinates, especially when you want ranked results with structured address normalization. Prefer it over reverse geocoding endpoints when you have text input rather than coordinates. It supports country-biasing and language preferences, making it suitable for international use cases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:22.267Z","isFirstParty":false}