{"uid":"cap_aB9vV2XSRqS0JRvHGyq5D","slug":"api-acre-place-geocode-f73fc88a","name":"API Acre Place Geocode","description":"Resolve one global city or locality name into bounded, population-ranked GeoNames coordinates, country and first-level-region identity, population, timezone, feature code, and source freshness without a request-time network call.","url":"https://apiacre.com/v1/data/place-geocode?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer"},"place":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"query":{"limit":5,"place":"London, GB","normalized":"london, gb"},"source":{"dataset":"GeoNames cities500","provider":"GeoNames","aliasRecords":766415,"placeRecords":235408,"snapshotBuiltOn":"2026-08-18"},"results":[{"name":"London","rank":1,"country":{"code":"GB","iso3":"GBR","name":"United Kingdom","continentCode":"EU"},"geonameId":2643743,"matchedNameType":"primary"}],"version":"apiacre-place-geocode/1","ambiguous":true,"limitations":["Coverage follows the GeoNames cities500 extract: populated places above 500 r...","Matching is exact after Unicode-to-ASCII normalization; this endpoint does no...","Unqualified names can be ambiguous. Review country, first-level region, GeoNa...","Population-based ranking is a selection aid, not proof that the first candida...","Results use the bundled 2026-08-18 snapshot and can differ from newer GeoName..."],"candidateCount":2,"resultsTruncated":false,"candidateCountCapped":false},"meta":{"cached":false,"sources":[],"warnings":[],"duration_ms":42,"next_actions":[{"path":"/v1/data/us-weather-forecast","title":"Global weather forecast","method":"POST","reason":"Use one selected place candidate's coordinates for a separately authorized cu...","service":"data.us-weather-forecast"}]},"service":"data.place-geocode","version":"1","request_id":"018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yjGcrfaGh5TsUAJStYqrx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a global city or locality name into GeoNames-backed coordinates, country, region, population, timezone, and feature metadata without a live network call.","exampleAgentPrompt":"Can you geocode 'London, GB' for me and return up to 5 candidate matches with their coordinates, country info, GeoNames IDs, and population rankings?","exampleUseCases":[{"title":"Disambiguate city name for weather pipeline","prompt":"I need the top 3 GeoNames candidates for 'Springfield, US' — give me their coordinates, country, and population ranking so I can pick the right one before fetching a weather forecast."},{"title":"Enrich user-submitted city to structured geo data","prompt":"A user typed 'Munich' in our form — can you resolve that to its canonical coordinates, country code, GeoNames ID, and timezone so we can store structured location data?"},{"title":"Validate and rank city name for logistics routing","prompt":"We're processing a shipment labeled 'Valencia' — can you look that up and return the top 2 population-ranked matches with their country and region so we confirm the right Valencia?"}],"resultDescription":"Returns a JSON object containing: the normalized query, dataset source metadata (GeoNames cities500 snapshot date), and an array of ranked place results each with name, GeoNames ID, coordinates, country code/ISO3/name/continent, matched name type, population rank, and an ambiguity flag. Also includes candidate count, truncation status, and next-action suggestions for follow-on endpoints.","failureModes":["Unrecognized or misspelled place name returns zero results","Highly ambiguous unqualified names return multiple candidates requiring caller disambiguation","Place names with fewer than 500 population are not in the cities500 dataset and will not match","Non-ASCII characters are normalized to ASCII before matching; unusual transliterations may miss","Snapshot data may lag live GeoNames by days; very new or renamed places may be absent","Missing required 'place' field returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need fast, offline-style geocoding of city or locality names without incurring a live geocoding API call latency, and when GeoNames coverage (populated places above 500 population) is sufficient. Prefer it over real-time geocoding APIs when cost, latency, or reliability of external calls is a concern. It is especially useful when you need population-ranked disambiguation of ambiguous city names, structured country/region identity, or timezone data alongside coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:40:46.975Z","isFirstParty":false,"canonicalSlug":"api-acre-place-geocode-f73fc88a"}