# Brazil IBGE Name Ranking by State

> Brazil IBGE Name Ranking by State is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns a ranked list of the most common first names in a Brazilian state, based on IBGE census data, filtered by IBGE UF state ID.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/brazil-ibge-name-ranking-by-state
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brazil-ibge-name-ranking-by-state-d9231c95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qA4d4yGEn3ymJ_Us0wtBS

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 brazil-ibge-name-ranking-by-state-d9231c95 -d '<json body>'
```

Example prompt: What are the most common first names in Rio de Janeiro state according to IBGE census data? Use IBGE UF ID 33 for Rio de Janeiro.

## When to prefer this

Use this endpoint when you need official IBGE census-based name frequency or popularity rankings scoped to a specific Brazilian state. Prefer this over generic name databases when you need Brazil-specific, government-sourced demographic name data at the state level.

## Known failure modes

- Invalid or missing IBGE UF ID results in an error or empty response
- Unrecognized state ID (e.g. out-of-range integer) returns no data
- Network timeout or service unavailability returns a 5xx error
- Payment not processed results in a 402 Payment Required response

## How this service works

Brazil IBGE census ranking of most common first names for a state (IBGE UF id, e.g. 33 = Rio de Janeiro) Query: ?q= Returns JSON.

## Output

A JSON array or object containing a ranked list of the most common first names for the specified Brazilian state, sourced from IBGE census data, including names and their relative frequency or rank.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brazil-ibge-name-ranking-by-state-d9231c95/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)