# IBGE on looot

IBGE gives your agent 3 jobs through looot: municipalities ibge places, data ibge sidra, metadata ibge sidra. 3 endpoints run today, some of them free.

## At a glance

- Category: Other
- Access: No key needed: these endpoints are open, looot calls them for you
- Price: some free

## Choose it when

- You need to municipalities ibge places: IBGE is the only provider on looot that runs this job today.
- You need to data ibge sidra: IBGE is the only provider on looot that runs this job today.
- You need to metadata ibge sidra: IBGE is the only provider on looot that runs this job today.
- You want to start without any key: some of its endpoints are open and looot calls them for you.

## Endpoints and jobs

| Endpoint | Job | Price | Runs (30 days) | Benchmark |
|---|---|---|---|---|
| [Municipalities of a Brazilian state with their IBGE codes](/public-catalog/ibge-municipalities) | `ibge.places.municipalities` | free | 44.4% of 18 runs without an error, median 10.3 s | no benchmark yet |
| [Values from a SIDRA table by variable, period and place](/public-catalog/ibge-sidra-data) | `ibge.sidra.data` | free | not enough runs to rank | no benchmark yet |
| [What a SIDRA table contains (variables, levels, periods)](/public-catalog/ibge-sidra-metadata) | `ibge.sidra.metadata` | free | not enough runs to rank | no benchmark yet |

## How the numbers are measured

Run numbers are looot's own runs of each endpoint over the last 30 days: the share that completed without an error, and the median time to answer. An endpoint with fewer than 10 runs in that window shows "not enough runs to rank" and is never ranked. Prices are what looot charges per call or per result, fee included, read from the live catalog; you prepay credit and each call is charged when it runs.

Read 2026-11-10 23:22 UTC.

## For agents

The minimal request for Municipalities of a Brazilian state with their IBGE codes (`ibge-municipalities`). Replace each <placeholder> with your value and send a new idempotency key per run.

### MCP

```json
{
  "endpointId": "ibge-municipalities",
  "input": {
    "state": "<state>"
  },
  "idempotencyKey": "<a new id per run>"
}
```

### REST

```bash
curl -X POST https://api.looot.ai/v1/runs \
  -H "Authorization: Bearer $LOOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpointId":"ibge-municipalities","input":{"state":"<state>"},"idempotencyKey":"<a new id per run>"}'
```

### CLI

```bash
looot run ibge-municipalities --input '{"state":"<state>"}'
```
