{"uid":"cap_wy4gss6C77w3f9xjR9GFS","slug":"tbs-geocoding-api-forward-geocoding-3d7269c4","name":"TBS Geocoding API – Forward Geocoding","description":"Geocoding for AI agents in one sub-cent call: forward geocoding (place name or address to coordinates), reverse geocoding (lat/lon to address) and place search. Open-Meteo + BigDataCloud, keyless, unified schema, USDC-payable via x402 on Base.","url":"https://geo-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":{"type":"json","example":{"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"source":"open-meteo","location":{"lat":48.85341,"lon":2.3488,"name":"Paris","admin1":"Île-de-France","admin2":"Paris","country":"France","timezone":"Europe/Paris","population":2138551,"country_code":"FR","feature_code":"PPLC"},"request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","generated_at":"2026-08-11T12:00:00.000Z"}},"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_HF8FsQIa-lIfoe3TY4-N7","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 geographic coordinates and location metadata via a keyless, sub-cent API call payable in USDC on Base.","exampleAgentPrompt":"What are the latitude and longitude coordinates for Paris, France? I need the full location details including timezone and population.","exampleUseCases":[{"title":"Resolve delivery address to coordinates","prompt":"I need to geocode '221B Baker Street, London' — can you get me the latitude, longitude, and country details so I can pass them to our routing system?"},{"title":"Enrich city data for weather lookup","prompt":"I have the city name 'Tokyo' and need its exact coordinates and timezone so I can fetch a weather forecast for it."},{"title":"Geolocate user-entered place for mapping","prompt":"A user typed 'Sydney Opera House' into our app — can you convert that to lat/lon coordinates so I can pin it on the map?"}],"resultDescription":"A JSON object containing the matched location's latitude, longitude, place name, first- and second-level administrative regions, country name, country code, IANA timezone string, population, and feature code, along with the data source, a unique request ID, and a timestamp. If no match is found, the location field is null.","failureModes":["No matching location found — location field returns null for ambiguous or misspelled queries","Missing required query parameter q or address returns an HTTP 400 error","Payment not provided or rejected by x402 middleware returns HTTP 402 Payment Required","Upstream Open-Meteo geocoding service unavailable causes a 502 or 503 response","Rate limit exceeded on the underlying provider returns an error response"],"whenToPreferThis":"Choose this endpoint when you need a keyless, pay-per-call forward geocoding solution that requires no API key setup, supports USDC micropayments via x402 on Base, and returns a unified schema with timezone and population metadata alongside coordinates. Ideal for AI agents that need to resolve place names on demand without managing credentials or subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:35:39.884Z","isFirstParty":false,"canonicalSlug":"tbs-geocoding-api-forward-geocoding-3d7269c4"}