{"uid":"cap_M_Ct94RSlTldm3BL3tnWh","slug":"tbs-geocoding-api-forward-geocoding-9c5969c1","name":"TBS Geocoding API – Forward Geocoding","description":"Forward geocoding for AI agents: turn a place name or address into coordinates. Returns the best-match latitude, longitude, country and ISO country code, administrative regions (admin1/admin2), population, IANA timezone and GeoNames feature code. Query by q= or address=. Sourced from Open-Meteo geocoding — keyless, unified schema, stablecoin-payable.","url":"https://x402.tbs-digital.com/geo/forward?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","description":"Place name / address to geocode, e.g. Paris"},"address":{"type":"string","description":"Alias for q"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"source":{"type":"string"},"location":{"type":"object","nullable":true},"request_id":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":null,"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_wfyXhG3H0TRWAtvxGDaVK","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":"Converts a place name or address string into latitude, longitude, country, administrative regions, timezone, and GeoNames feature code","exampleAgentPrompt":"What are the latitude and longitude coordinates for Lyon, France, and what timezone is it in?","exampleUseCases":[{"title":"Enrich delivery address with coordinates","prompt":"I have a customer address — '15 Rue de Rivoli, Paris' — can you look up its latitude, longitude, and country code so I can pass it to our logistics system?"},{"title":"Resolve city name for weather pipeline","prompt":"Before I fetch the weather, I need the coordinates for Nairobi, Kenya — can you geocode it and give me the lat, lon, and IANA timezone?"},{"title":"Identify region and timezone for scheduling","prompt":"A user signed up with location 'Munich' — what country, admin region, and IANA timezone does that map to so I can schedule their notifications correctly?"}],"resultDescription":"Returns a best-match location object including latitude, longitude, country name, ISO country code, admin1 and admin2 administrative regions, population estimate, IANA timezone identifier, and GeoNames feature code, along with request metadata such as source, request_id, and generated_at timestamp.","failureModes":["Ambiguous place name returns best-guess match that may not be the intended location","Very obscure or misspelled place names may return no result or a wrong match","No result returned for purely postal-code-only queries if not supported","Network or upstream Open-Meteo service unavailability causes error response","Missing q or address parameter results in a bad request error"],"whenToPreferThis":"Choose this endpoint when you need a fast, keyless, stablecoin-payable forward geocoding call that returns a unified schema including timezone and admin regions — especially useful for AI agent pipelines needing structured location enrichment without managing API keys or complex billing. Prefer it over raw Open-Meteo geocoding when you want a normalized response with x402 micropayment support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:47:03.838Z","isFirstParty":false,"canonicalSlug":"tbs-geocoding-api-forward-geocoding-9c5969c1"}