{"uid":"cap_-sR65267KiIpN2cT_KwrK","slug":"tbs-geocoding-api-place-search-1e844d51","name":"TBS Geocoding API – Place Search","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/places?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 to search, e.g. Springfield"},"count":{"type":"string","description":"Max results 1-20 (default 5)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"count":{"type":"number"},"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"places":{"type":"array"},"source":{"type":"string"},"request_id":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"places":[{"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"}],"source":"open-meteo","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_rsnXYlk7pHQocRUxCf_6k","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":"Searches for places by name and returns geographic coordinates, administrative details, timezone, population, and country info.","exampleAgentPrompt":"Can you search for 'Lyon' and give me its coordinates, timezone, and country — just the top result?","exampleUseCases":[{"title":"Weather app location resolution","prompt":"I want to show weather for 'Bordeaux' — can you find its coordinates so I can pass them to the forecast service?"},{"title":"Timezone lookup for scheduling","prompt":"What timezone is 'Osaka' in? I need to schedule a meeting with someone there and want to make sure I get the offset right."},{"title":"Disambiguating common place names","prompt":"Search for 'Springfield' and show me the top 5 results with their country and region — I need to figure out which one the user means."}],"resultDescription":"Returns a JSON array of matching places, each with latitude, longitude, place name, admin1 and admin2 regions, country name and ISO code, timezone string, population, and OpenStreetMap feature code. Also includes a result count, data source identifier, request ID, and generation timestamp. Payer wallet address and network are included for x402 billing traceability.","failureModes":["Missing required 'q' parameter returns an error or empty result set","No matching places found returns count 0 with empty places array","Count parameter outside 1-20 range may be clamped or rejected","Upstream Open-Meteo API downtime causes service unavailability","x402 payment failure prevents request from completing"],"whenToPreferThis":"Choose this endpoint when you need sub-cent, keyless place search that returns structured geo data (coordinates, timezone, population, admin regions) in a single call payable in USDC on Base. Prefer it over free tier geocoders that require API keys, or over heavier geocoding APIs when you only need forward place-name lookup with a unified schema. Ideal for AI agents that need to resolve a city or place name to coordinates before calling a weather, timezone, or mapping service.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:37:40.655Z","isFirstParty":false,"canonicalSlug":"tbs-geocoding-api-place-search-1e844d51"}