# astro.dutchdata.io Location Search (US/NY)

> astro.dutchdata.io Location Search (US/NY) 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-13).

Searches for cities and locations within a US state (e.g. New York) by name query, returning rich location data including coordinates, timezone, and population

## Facts

- Endpoint: GET https://astro.dutchdata.io/api/locations/US/NY/search
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/astro-dutchdata-io-location-search-us-ny-2c7a210d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HaHls6kNDoCeMdYsC_oRf

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-search-us-ny-2c7a210d
```

Example prompt: Can you search for cities named 'Rochester' in New York state (US/NY) and give me back their coordinates, timezone, and population?

## When to prefer this

Use this endpoint when you need to search for cities or locations within a specific US state by partial or full name, and want rich location metadata (coordinates, timezone, population) in return. Prefer this over generic geocoding APIs when you specifically need to filter by US state/region and want structured city-level data with population included.

## Known failure modes

- No matching cities found for the query string — returns empty array
- Invalid region_code or country_code path parameter — may return 404 or empty result
- Missing query parameter — may return all locations up to the limit or an error
- Payment not processed (x402) — returns 402 Payment Required before data is delivered
- Rate limiting or service unavailability — returns 5xx error

## How this service works

Location data

## Output

A JSON array of location objects, each containing: numeric location ID, latitude, longitude, city name, IANA timezone string, population count, region_code (e.g. 'NY'), and country_code (e.g. 'US'). Default limit is 50 results.

## 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": {
      "limit": {
       "type": "string",
       "description": "Maximum results (default 50)"
      },
      "query": {
       "type": "string",
       "description": "City-name search text"
      },
      "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": "array",
      "items": {
       "$ref": "#/components/schemas/RichLocation"
      }
     },
     "example": [
      {
       "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-search-us-ny-2c7a210d/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)