{"uid":"cap_KrQpOdMPeDYNEjwYoa-Nf","slug":"suverse-places-geocoding-search-open-meteo-4df59b19","name":"Suverse Places Geocoding Search (Open-Meteo)","description":"Search for a city or town by name and get back matching places with coordinates, country code, timezone, elevation, and population. Pass a name (and optional count), get structured results. Free Open-Meteo geocoding.","url":"https://proxy.suverse.io/v1/data/suverse-places-omgeo-search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.055","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.055/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.055","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.055","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VNzMcHCCWe67ffXSobFHw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.055","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for cities or towns by name and return matching places with coordinates, country code, timezone, elevation, and population.","exampleAgentPrompt":"Can you look up 'Springfield' and return the top 5 matching cities with their coordinates, country, timezone, and population?","exampleUseCases":[{"title":"Resolve city coordinates for weather lookup","prompt":"I need the latitude and longitude for Zurich so I can pull a weather forecast — can you search for it and give me its coordinates and timezone?"},{"title":"Identify country and timezone for scheduling","prompt":"What country and timezone is Nairobi in? Search for it by name and give me the details."},{"title":"Find top matching cities for an ambiguous name","prompt":"There are multiple cities called 'Valencia' — can you search for that name and return the top 5 results with their country codes, populations, and coordinates?"}],"resultDescription":"A structured list of matching places, each containing the place name, latitude, longitude, country code, timezone identifier, elevation in meters, and population count. Results are ordered by relevance to the query name.","failureModes":["No matching places found for the given name — returns empty results list","Ambiguous or misspelled name returns unexpected or irrelevant cities","Missing required 'name' field in body causes a 400/422 validation error","Upstream Open-Meteo geocoding API unavailability causes a 502/503 error","Payment not processed via x402 protocol results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to resolve a human-readable city or town name into structured geographic metadata (coordinates, timezone, country, elevation, population) without requiring an API key. Prefer this over paid geocoding APIs (Google Maps, Mapbox) when cost per call is acceptable and open data accuracy is sufficient. Ideal for bootstrapping location-aware workflows, seeding weather or routing queries, or enriching records with geographic context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:57:39.524Z","isFirstParty":false}