{"uid":"cap_V2Tvh-FVn_RghlciAIceM","slug":"api-agentstools-dev-geocode-95ad5ed1","name":"api.agentstools.dev Geocode","description":"Forward-geocode a street address or place name (WORLDWIDE) to coordinates + parsed address components via OpenStreetMap Nominatim (public, keyless).","url":"https://api.agentstools.dev/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Street address or place name (any country)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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":{"p10Cents":"0.2000","medianCents":"0.2000","p90Cents":"0.2000","minCents":"0.2000","maxCents":"0.2000","p95Cents":"0.2000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_amwEah4SyZE3GqID5BnaG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Forward-geocodes a street address or place name worldwide to geographic coordinates and parsed address components using OpenStreetMap Nominatim.","exampleAgentPrompt":"What are the GPS coordinates for 1600 Pennsylvania Avenue NW, Washington DC? I need latitude and longitude plus the parsed address components.","exampleUseCases":[{"title":"Map delivery address to coordinates","prompt":"I have a customer shipping address — 221B Baker Street, London — and I need to pin it on a map. Can you get me the latitude and longitude plus the full parsed address components?"},{"title":"Geocode international branch locations","prompt":"We have a new office opening at Av. Paulista 1578, São Paulo, Brazil. Look up the GPS coordinates for that address so I can add it to our global office directory."},{"title":"Resolve landmark name to GPS","prompt":"I want to get directions to the Eiffel Tower in Paris. Can you find the exact coordinates for it so I can plug them into our routing system?"}],"resultDescription":"Returns geographic coordinates (latitude and longitude), a structured parsed address broken into components (road, city, state, country, postcode, etc.), a display name string, and optionally a bounding box — all sourced from OpenStreetMap Nominatim, no API key required.","failureModes":["Address not found or ambiguous — returns empty results array","Malformed or missing address query parameter — returns 400 error","Nominatim rate limiting or temporary unavailability — returns 5xx error","Non-existent or fictional place returns empty result set"],"whenToPreferThis":"Choose this endpoint when you need to convert any free-text address or place name (worldwide, any language) to coordinates without managing an API key, and when you also want structured parsed address components back alongside coordinates. It's especially useful for agents performing location enrichment, mapping, or routing tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:48:05.033Z","isFirstParty":false,"canonicalSlug":"api-agentstools-dev-geocode-95ad5ed1"}