{"uid":"cap_F_t0lPEAGNx-TGxVd2_fy","slug":"tbs-geocoding-api-place-search-autocomplete-4bff2c1b","name":"TBS Geocoding API – Place Search Autocomplete","description":"Place search / geocoding autocomplete for AI agents: return the top matching places for a name query. Each result carries name, latitude, longitude, country and ISO code, administrative regions, population, timezone and feature code. Query by q= with an optional count= (1-20, default 5). Sourced from Open-Meteo geocoding — keyless, unified schema.","url":"https://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":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_e3mMomAtri33iKwYV8Yk0","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":"Returns top matching places for a name query, including coordinates, country, administrative regions, population, timezone, and feature code.","exampleAgentPrompt":"Search for places named 'Lyon' and give me the top 3 results with their coordinates, country, timezone, and administrative region.","exampleUseCases":[{"title":"Resolve city name to coordinates","prompt":"I need the latitude and longitude for 'Bordeaux, France' — can you look it up and return the coordinates, timezone, and region?"},{"title":"Disambiguate common place names","prompt":"There are many cities named Springfield — can you search for 'Springfield' and show me the top 5 results with their country, population, and coordinates so I can pick the right one?"},{"title":"Enrich address data with geo metadata","prompt":"I have a list of city names from customer signups — can you look up 'Munich' and give me its ISO country code, administrative region, population, and timezone so I can enrich our records?"}],"resultDescription":"A JSON array of up to 20 matching places (default 5), each containing: name, latitude, longitude, country name, ISO country code, administrative subdivision levels, population, timezone, and feature code (e.g. city, town). Also includes result count, source attribution, request ID, and generation timestamp.","failureModes":["Missing or empty q= parameter returns no results or an error","Highly ambiguous or misspelled place names may return irrelevant results","count= outside 1-20 range may be clamped or cause a validation error","Very obscure or uninhabited locations may return zero results","Network or upstream Open-Meteo outage causes service unavailability"],"whenToPreferThis":"Choose this endpoint when you need fast, keyless place-name-to-coordinates resolution with rich metadata (admin regions, population, timezone, feature code) for up to 20 results per query. It is ideal for AI agents needing geocoding without managing API keys, and when Open-Meteo's global coverage and unified schema suffice. Prefer alternatives if you need reverse geocoding (coordinates to address), street-level address parsing, or routing/directions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:55:06.401Z","isFirstParty":false,"canonicalSlug":"tbs-geocoding-api-place-search-autocomplete-4bff2c1b"}