# opendata402 Global City & Place Lookup

> opendata402 Global City & Place Lookup is a paid API for AI agents from opendata402.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-15).

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.

## Facts

- Endpoint: GET https://opendata402.com/v1/places?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/opendata402-global-city-place-lookup-d45ff822
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1b8WVf6LHG-Z-xL6Pfrsw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability opendata402-global-city-place-lookup-d45ff822
```

Example prompt: What are the coordinates and time zone for Springfield in the United States? Search worldwide cities for 'Springfield' and filter to the US.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/opendata402-global-city-place-lookup-d45ff822/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from opendata402.com](https://www.zero.xyz/host/opendata402.com/llms.txt)