# Agent Hub Geocoding

> Agent Hub Geocoding is a paid API for AI agents from agents.torbrooknews.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-13).

Converts a place name, landmark, or street address into latitude/longitude coordinates with city, region, country, postcode, timezone, and population data.

## Facts

- Endpoint: GET https://agents.torbrooknews.com/v1/geocode?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-hub-geocoding-3493d5a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5yzsAKgNzBlRLNU7IfKlN

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 agent-hub-geocoding-3493d5a1
```

Example prompt: Can you geocode '10 Downing Street, London' and give me its latitude, longitude, postcode, and timezone?

## When to prefer this

Choose this endpoint when you need to resolve a free-text place name, address, or landmark to geographic coordinates along with enriched metadata (timezone, postcode, population) without requiring a full mapping SDK. It combines GeoNames city data with OpenStreetMap POI/address data in a single call, making it ideal for enriching structured records or powering location-aware workflows on a pay-per-call basis.

## Known failure modes

- No results found for an ambiguous or misspelled query
- Partial data returned when postcode, population, or timezone is not available for a location
- Rate limiting or payment failure when x402 payment is not processed
- Query returns unexpected results for place names shared across multiple countries
- Limit parameter out of range (must be 1–10)

## How this service works

Geocode a place, landmark or street address to latitude/longitude with city, region, country, postcode, timezone and population where known. Cities via GeoNames, addresses and points of interest via OpenStreetMap.

## Output

Returns up to 10 geocoding results (default 5), each containing latitude, longitude, city, region, country, postcode, timezone, and population where available. Results are sourced from GeoNames for cities and OpenStreetMap for addresses and points of interest.

## 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",
       "description": "Place, landmark or address"
      },
      "limit": {
       "type": "integer",
       "description": "1 to 10, default 5"
      }
     }
    }
   },
   "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/agent-hub-geocoding-3493d5a1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.torbrooknews.com](https://www.zero.xyz/host/agents.torbrooknews.com/llms.txt)