# Satellite Observation API

> Satellite Observation API is a paid API for AI agents from tools.ipintel.ai, paid per call via x402, $0.09/call, status unknown (last checked 2026-09-15).

Returns a satellite image of a given location in true-color or other modes via a pay-per-call x402 POST endpoint

## Facts

- Endpoint: POST https://tools.ipintel.ai/satellite
- Price: $0.09/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/satellite-observation-api-18ca7d0e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HkYZy9YGnoa8AtjBY0Ebh

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 satellite-observation-api-18ca7d0e -d '<json body>'
```

Example prompt: Can you pull a true-color satellite image for coordinates 37.7749° N, 122.4194° W — I want to see an overhead view of that area.

## When to prefer this

Choose this endpoint when an agent needs to fetch a satellite image for a specific geographic coordinate via a simple pay-per-call API without requiring a subscription or API key setup. It is well-suited for lightweight geospatial workflows, one-off location inspections, or autonomous agents that need on-demand aerial imagery with x402 micropayment support.

## Known failure modes

- Invalid or out-of-range coordinates return an error response
- Missing required location parameters cause request failure
- Payment authorization failure via x402 protocol blocks the call
- Unsupported observation mode value returns an error
- Network timeout if the satellite imagery backend is slow to respond

## How this service works

IPIntel.ai x402 Tools package. Satellite Observation API for satellite imagery from coordinates, radius, mode and date. Supports true color, vegetation, water, thermal and radar modes with cloud-aware fallback. Uses Sentinel/Copernicus data from 2017 to present for earth observation, OSINT, site monitoring and change-over-time analysis.

## Output

Returns a JSON object with ok status, the mode used (e.g. true_color), the tool name ('satellite'), and an image object containing a clean URL pointing to the generated satellite image PNG hosted on tools.ipintel.ai.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "additionalProperties": true,
     "properties": {
      "lat": {
       "type": "number",
       "minimum": -90,
       "maximum": 90,
       "description": "Latitude of the observation center."
      },
      "lon": {
       "type": "number",
       "minimum": -180,
       "maximum": 180,
       "description": "Longitude of the observation center."
      },
      "radius_m": {
       "type": "integer",
       "minimum": 100,
       "maximum": 5000,
       "default": 3000,
       "description": "Observation radius in meters."
      },
      "mode": {
       "type": "string",
       "enum": [
        "true_color",
        "vegetation",
        "water",
        "thermal",
        "radar"
       ],
       "default": "true_color",
       "description": "Observation mode."
      },
      "max_cloud_cover": {
       "type": "number",
       "minimum": 0,
       "maximum": 100,
       "default": 20,
       "description": "Maximum cloud cover for optical modes."
      },
      "fallback": {
       "type": "boolean",
       "default": true,
       "description": "Allow best available scene fallback."
      }
     },
     "required": [
      "lat",
      "lon"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "additionalProperties": true,
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "tool": {
       "type": "string"
      },
      "mode": {
       "type": "string"
      },
      "fulfillment_status": {
       "type": "string"
      },
      "request": {
       "type": "object",
       "additionalProperties": true,
       "properties": {
        "lat": {
         "type": "number"
        },
        "lon": {
         "type": "number"
        },
        "radius_m": {
         "type": "integer"
        },
        "date": {
         "type": "string"
        },
        "date
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "mode": "true_color",
  "tool": "satellite",
  "image": {
   "clean_url": "https://tools.ipintel.ai/results/satellite/example.png"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/satellite-observation-api-18ca7d0e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.ipintel.ai](https://www.zero.xyz/host/tools.ipintel.ai/llms.txt)