# Brazilayer Deforestation Ranking

> Brazilayer Deforestation Ranking is a paid API for AI agents from api.brazilayer.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Ranks Brazilian municipalities or states by deforestation area cleared within a user-specified time window, filterable by biome, using official INPE satellite alerts.

## Facts

- Endpoint: GET https://api.brazilayer.com/v1/desmatamento/ranking
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brazilayer-deforestation-ranking-8978f810
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RIVbfazGDAT3NfHLLjENV

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 brazilayer-deforestation-ranking-8978f810
```

Example prompt: Show me the top 20 most deforested municipalities in the Amazon biome over the last 180 days, ranked by area cleared, using INPE satellite data.

## When to prefer this

Choose this endpoint when you need a comparative, ranked view of deforestation hotspots across Brazil — ideal for ESG screening, supply chain risk scoring, or carbon project integrity checks where you need to identify which geographic units have the highest clearance activity in a specific period and biome. Prefer the companion municipality-profile endpoint if you need a detailed deforestation breakdown for a single known location rather than a cross-entity ranking.

## Known failure modes

- Invalid 'por' value (not 'municipio' or 'uf') returns a 400 error
- 'dias' exceeding 2000 returns a validation error
- Invalid 'bioma' value (not 'amazonia' or 'cerrado') returns a 400 error
- 'limite' exceeding 50 is rejected
- Payment not included or insufficient USDC triggers a 402 response
- INPE data source unavailability may cause delayed or empty results

## How this service works

Where Brazilian deforestation is concentrated right now: rank municipalities or states by area cleared in a window you choose, filterable by biome (Amazon or Cerrado), from official INPE satellite alerts. Feeds ESG screening, carbon-project integrity checks and commodity-origin risk. Free sample, no payment: https://api.brazilayer.com/v1/desmatamento/amostra

## Output

A ranked list (up to 50 entries) of Brazilian municipalities or states ordered by deforestation area cleared within the specified time window, drawn from official INPE satellite alerts. Each entry includes the geographic unit name, biome, and area cleared, enabling direct comparison of deforestation hotspots.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "por": {
       "type": "string",
       "description": "municipio | uf"
      },
      "dias": {
       "type": "integer",
       "description": "window in days, max 2000"
      },
      "bioma": {
       "type": "string",
       "description": "amazonia | cerrado"
      },
      "limite": {
       "type": "integer",
       "description": "max 50"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brazilayer-deforestation-ranking-8978f810/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.brazilayer.com](https://www.zero.xyz/host/api.brazilayer.com/llms.txt)