> For the complete documentation index, see [llms.txt](https://trust-positif.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trust-positif.gitbook.io/docs/rate-limits.md).

# Rate limits & quota

## Rate limit HTTP

Maksimal **60 request per menit** per IP pada semua endpoint `/api/v1/*`.

Jika melebihi batas ini, Anda mendapat **429 Too Many Requests** (bukan karena kuota domain habis).

## Kuota domain

### Freemium — tanpa API key

| Limit              | Nilai            |
| ------------------ | ---------------- |
| Domain per hari    | 100 / IP         |
| Domain per request | 100              |
| Reset harian       | Tengah malam UTC |

### Freemium — dengan API key

| Limit              | Nilai                                   |
| ------------------ | --------------------------------------- |
| Domain per hari    | Default **100** (sesuai limit key Anda) |
| Domain per request | 100                                     |

### Premium — API key + paket aktif

| Limit              | Nilai                   |
| ------------------ | ----------------------- |
| Kuota              | Sisa paket bulanan Anda |
| Biaya API          | **3 kredit per domain** |
| Domain per request | 100                     |

Contoh: cek 10 domain = **30 kredit** terpotong.

## Cek sisa kuota

`GET /api/v1/limit` atau `GET /api/v1/stats` — lihat [Usage & quota](/docs/api-reference/usage-stats.md).

### Freemium

```json
{
  "success": true,
  "limit": {
    "type": "freemium",
    "rate_limit": {
      "limit": 100,
      "used": 12,
      "remaining": 88
    }
  }
}
```

### Premium

```json
{
  "success": true,
  "limit": {
    "type": "premium",
    "quota": {
      "total": 12500,
      "remaining": 12400,
      "used": 100
    },
    "cost_per_request": 3,
    "period": "monthly",
    "package_name": "Business"
  }
}
```

## Paket (referensi)

| Paket        | Kuota/bulan | Harga (IDR) |
| ------------ | ----------- | ----------- |
| Free         | 100         | 0           |
| Starter      | 1.000       | 200.000     |
| Professional | 3.000       | 500.000     |
| Business     | 12.500      | 1.500.000   |

Harga dan kuota aktual — lihat [trustpositif.id/packages](https://trustpositif.id/packages).

## Tips

* Gabungkan banyak domain dalam satu request `/check` (hingga 100).
* Premium: hitung `jumlah domain × 3` sebelum batch besar.
* Field `stats` pada response `/check` juga menampilkan sisa kuota.