{"uid":"cap_99XJBofhVAb3VDdT1csti","slug":"suverse-geo-place-by-name-us-city-to-zip-coordinates-3a6b5887","name":"Suverse Geo Place-by-Name (US City to ZIP + Coordinates)","description":"Resolve a US city by state + name to its postal codes with latitude and longitude via keyless Zippopotam. For agents geocoding US places by name instead of ZIP.","url":"https://proxy.suverse.io/v1/data/suverse-geo-place-by-name","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.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JSg3HNvrKFq2tpOmSu-aF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a US city name and state to its postal codes with latitude and longitude using the Zippopotam service.","exampleAgentPrompt":"What are the ZIP codes and coordinates for Austin, Texas? Look it up by city name and state.","exampleUseCases":[{"title":"Delivery zone setup by city","prompt":"I need all the ZIP codes and their lat/lon coordinates for Portland, Oregon so I can configure our delivery zone boundaries — can you look that up by city name?"},{"title":"Enriching user address records","prompt":"We have customers who only gave us their city and state — can you look up the postal codes and coordinates for Denver, Colorado so we can fill in the missing location data?"},{"title":"Mapping a city's coverage area","prompt":"What are all the postal codes in Nashville, Tennessee along with their latitude and longitude? I want to map out the full city coverage area."}],"resultDescription":"Returns a list of ZIP/postal codes associated with the queried US city and state, each with its latitude and longitude coordinates, along with the place name and state abbreviation as confirmed by Zippopotam.","failureModes":["City name not found in Zippopotam database — returns empty or error response","Invalid or misspelled state abbreviation — lookup fails","City exists but has no postal codes in the dataset — empty result","Upstream Zippopotam service unavailable — proxy returns error","Payment failure (x402) — request not processed"],"whenToPreferThis":"Use this endpoint when you need to geocode a US city by name and state rather than starting from a ZIP code, and want all associated postal codes with lat/lon in a single keyless call. Prefer it over direct Zippopotam calls when operating in an x402 payment-gated agent environment without API key management overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:51:28.379Z","isFirstParty":false}