# AiToollab Weather API — City Weather Lookup

> AiToollab Weather API — City Weather Lookup is a paid API for AI agents from api.aitoollab.top, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-07).

Returns current weather conditions (temperature, humidity, wind speed, description) for a given city name.

## Facts

- Endpoint: GET https://api.aitoollab.top/api/weather/%7Bcity%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-07
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aitoollab-weather-api-city-weather-lookup-20caf9ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BFK92dWqhwri6Ec7f96S2

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 aitoollab-weather-api-city-weather-lookup-20caf9ff
```

Example prompt: What is the current weather in Tokyo — give me the temperature, humidity, wind speed, and a description of conditions?

## When to prefer this

Use this endpoint when you need a simple, low-cost per-call weather lookup by city name returning basic current conditions. Suitable for lightweight integrations where only current temperature, humidity, wind speed, and sky description are needed and a $0.01 USDC micropayment per call is acceptable.

## Known failure modes

- City name not found or misspelled — likely returns empty or error response
- Unrecognized city slug in URL path — may return 404 or malformed JSON
- Network timeout — no response returned
- Rate limiting or payment failure — 402 response if x402 payment not satisfied

## How this service works

AiToollab，普通人用AI做副业的实战平台。收录10+AI副业方向、50+提示词模板、真实赚钱案例。每周更新，找方向、找工具、找案例，一站搞定。

## Output

A JSON object containing the city name, current temperature (numeric), humidity percentage, wind speed, a weather code, a human-readable weather description (e.g. 'Clear sky'), and a last-updated ISO 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "city": "{city}",
  "humidity": 65,
  "wind_speed": 10.2,
  "temperature": 22.5,
  "last_updated": "2026-04-27T00:00:00.000Z",
  "weather_code": 0,
  "weather_description": "Clear sky"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aitoollab-weather-api-city-weather-lookup-20caf9ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aitoollab.top](https://www.zero.xyz/host/api.aitoollab.top/llms.txt)