# TBS Geocoding API – Place Search Autocomplete

> TBS Geocoding API – Place Search Autocomplete is a paid API for AI agents from x402.tbs-digital.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-10).

Returns top matching places for a name query, including coordinates, country, administrative regions, population, timezone, and feature code.

## Facts

- Endpoint: GET https://x402.tbs-digital.com/geo/places?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-geocoding-api-place-search-autocomplete-4bff2c1b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F_t0lPEAGNx-TGxVd2_fy

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 tbs-geocoding-api-place-search-autocomplete-4bff2c1b
```

Example prompt: Search for places named 'Lyon' and give me the top 3 results with their coordinates, country, timezone, and administrative region.

## When to prefer this

Choose this endpoint when you need fast, keyless place-name-to-coordinates resolution with rich metadata (admin regions, population, timezone, feature code) for up to 20 results per query. It is ideal for AI agents needing geocoding without managing API keys, and when Open-Meteo's global coverage and unified schema suffice. Prefer alternatives if you need reverse geocoding (coordinates to address), street-level address parsing, or routing/directions.

## Known failure modes

- Missing or empty q= parameter returns no results or an error
- Highly ambiguous or misspelled place names may return irrelevant results
- count= outside 1-20 range may be clamped or cause a validation error
- Very obscure or uninhabited locations may return zero results
- Network or upstream Open-Meteo outage causes service unavailability

## How this service works

Place search / geocoding autocomplete for AI agents: return the top matching places for a name query. Each result carries name, latitude, longitude, country and ISO code, administrative regions, population, timezone and feature code. Query by q= with an optional count= (1-20, default 5). Sourced from Open-Meteo geocoding — keyless, unified schema.

## Output

A JSON array of up to 20 matching places (default 5), each containing: name, latitude, longitude, country name, ISO country code, administrative subdivision levels, population, timezone, and feature code (e.g. city, town). Also includes result count, source attribution, request ID, and generation timestamp.

## 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",
     "properties": {
      "q": {
       "type": "string",
       "description": "Place name to search, e.g. Springfield"
      },
      "count": {
       "type": "string",
       "description": "Max results 1-20 (default 5)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "payer": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "nullable": true
        },
        "network": {
         "type": "string"
        }
       }
      },
      "places": {
       "type": "array"
      },
      "source": {
       "type": "string"
      },
      "request_id": {
       "type": "string"
      },
      "generated_at": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tbs-geocoding-api-place-search-autocomplete-4bff2c1b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tbs-digital.com](https://www.zero.xyz/host/x402.tbs-digital.com/llms.txt)