{"uid":"cap_1b8WVf6LHG-Z-xL6Pfrsw","slug":"opendata402-global-city-place-lookup-d45ff822","name":"opendata402 Global City & Place Lookup","description":"Find cities and towns worldwide (all places with 15,000+ inhabitants, about 30,000) by name, optionally within a country: coordinates, country, region code, population, time zone and GeoNames id, largest first. Use it for geocoding place names, disambiguation and to get a time zone or coordinates for a city. GeoNames data, CC BY 4.0, refreshed nightly.","url":"https://opendata402.com/v1/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","required":["q"],"properties":{"q":{"type":"string","maxLength":80,"minLength":2,"description":"Place name (prefix match)."},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"ISO 3166-1 alpha-2 country code."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_gUJ3UoQcyCC8Cdv2gmX8F","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":"Search for cities and towns worldwide by name (and optionally country), returning coordinates, country, region, population, time zone, and GeoNames ID, sorted by population descending.","exampleAgentPrompt":"What are the coordinates and time zone for Springfield in the United States? Search worldwide cities for 'Springfield' and filter to the US.","exampleUseCases":[{"title":"Time zone lookup for scheduling","prompt":"I need to schedule a call with someone in Lyon, France — can you find the time zone for Lyon so I know what UTC offset to use?"},{"title":"Disambiguating a city name","prompt":"I have a city called 'San Jose' but I'm not sure if it's the one in California or Costa Rica — can you look up both and tell me their populations and coordinates?"},{"title":"Geocoding a city for a mapping app","prompt":"I need the latitude and longitude for Nairobi, Kenya to drop a pin on a map — can you look that up?"}],"resultDescription":"A JSON array of matching places (population ≥ 15,000), each containing the place name, latitude, longitude, country code, admin region code, population, IANA time zone identifier, and GeoNames ID, sorted largest population first. Typically returns multiple results when the name is ambiguous across countries or regions.","failureModes":["Query string too short (< 2 chars) or too long (> 80 chars) returns a validation error","No matching city found returns an empty results array","Invalid country code (not ISO 3166-1 alpha-2) returns a validation error","Places with fewer than 15,000 inhabitants are not indexed and will not be returned","Payment failure (x402) prevents the call from completing"],"whenToPreferThis":"Prefer this endpoint when you need fast, lightweight city-name geocoding with time zone and population data for cities worldwide, especially when disambiguation by country is needed. It is ideal for resolving place names to coordinates or time zones without requiring a full-featured geocoding API. Not suitable for street-level address geocoding, reverse geocoding, or places with fewer than 15,000 inhabitants.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:36:43.757Z","isFirstParty":false,"canonicalSlug":"opendata402-global-city-place-lookup-d45ff822"}