# astro.dutchdata.io Location Lookup

> astro.dutchdata.io Location Lookup is a paid API for AI agents from astro.dutchdata.io, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-15).

Returns geographic and timezone metadata for a specified city, region, and country

## Facts

- Endpoint: GET https://astro.dutchdata.io/api/locations/US/NY/New%20York
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/astro-dutchdata-io-location-lookup-35b4b157
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Sn5-qPrjA-JLkPHcx7bsF

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 astro-dutchdata-io-location-lookup-35b4b157
```

Example prompt: Look up the geographic details for New York, NY, US — I need the coordinates, timezone, and population for that city.

## When to prefer this

Use this endpoint when you need structured geographic metadata (coordinates, timezone, population) for a specific city identified by name, region code, and country code — particularly within the US. Prefer it when you need a location ID compatible with other astro.dutchdata.io endpoints such as astrological chart generation.

## Known failure modes

- City not found in database returns an error or empty location object
- Invalid or unsupported country/region code returns 4xx error
- Misspelled city name may return no results
- Network or payment failure returns 402 or 5xx response

## How this service works

Location data

## Output

A JSON object containing the city's unique location ID, latitude, longitude, city name, IANA timezone string (e.g. America/New_York), population count, region code (e.g. NY), and country code (e.g. US).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "properties": {
      "city": {
       "in": "path",
       "type": "string",
       "description": "path parameter"
      },
      "region_code": {
       "in": "path",
       "type": "string",
       "description": "path parameter"
      },
      "country_code": {
       "in": "path",
       "type": "string",
       "description": "path parameter"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "schema": {
      "type": "object",
      "required": [
       "location"
      ],
      "properties": {
       "location": {
        "$ref": "#/components/schemas/RichLocation"
       }
      }
     },
     "example": {
      "location": {
       "id": 5128581,
       "lat": 40.71427,
       "lon": -74.00597,
       "city": "New York",
       "timezone": "America/New_York",
       "population": 8804190,
       "region_code": "NY",
       "country_code": "US"
      }
     },
     "mimeType": "application/json"
    }
   }
  }
 },
 "description": "x402 Bazaar discovery metadata"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/astro-dutchdata-io-location-lookup-35b4b157/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from astro.dutchdata.io](https://www.zero.xyz/host/astro.dutchdata.io/llms.txt)