# lilambd Regions Search

> lilambd Regions Search is a paid API for AI agents from api.lilambd.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-02).

Search and retrieve geographic regions by name, country, or sorted by environmental/demographic metrics such as area, forest loss, built area, or population growth

## Facts

- Endpoint: GET https://api.lilambd.com/regions/search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lilambd-regions-search-1b34516f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EeUKnQ2uzw6jGg5syfpTv

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 lilambd-regions-search-1b34516f
```

Example prompt: Search for regions named 'Amazon' and return the top 10 results sorted by forest loss, so I can see which areas have experienced the most deforestation.

## When to prefer this

Use this endpoint when you need to search or enumerate geographic regions by name or country with environmental or demographic metrics (area, forest loss, built area, population growth). Prefer this over general geocoding APIs when you specifically need region-level environmental statistics or want to rank regions by ecological or demographic change indicators. It supports multilingual name queries, making it suitable for international use cases.

## Known failure modes

- No results returned (empty data array with count 0) when query matches nothing
- Invalid country code returns empty results or validation error
- limit parameter outside 1-200 range may return error or default to 50
- Missing required 'input' wrapper causes schema validation failure
- Network timeout or 402 payment failure if USDC payment is not properly attached

## How this service works

A crossing for play, feeling, language, science and computation — creating states that do not have names yet.

## Output

A JSON object containing an array of matching region records under 'data', a total count of matching results, and an attribution string crediting the data source licence. Each region record contains geographic and demographic metrics depending on the sort and filter applied.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Name in any language"
      },
      "sort": {
       "type": "string",
       "description": "area | forest_loss | built | population_growth"
      },
      "limit": {
       "type": "string",
       "description": "Max rows (1-200, default 50)"
      },
      "offset": {
       "type": "string",
       "description": "Rows to skip"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2"
      }
     },
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "count": 0,
  "attribution": "source licence line"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lilambd-regions-search-1b34516f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.lilambd.com](https://www.zero.xyz/host/api.lilambd.com/llms.txt)