> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hermai.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits & usage

> Rate limits, credits, and how usage works in the current release.

## Plans and credits

Hosted execution is priced in credits. Each plan includes a monthly credit allowance that resets on your billing date:

| Plan    | Price | Credits / month |
| ------- | ----- | --------------- |
| Free    | \$0   | 1,000           |
| Starter | \$49  | 15,000          |
| Pro     | \$149 | 60,000          |

Enterprise plans cover higher volumes with custom pricing. See [pricing](https://hermai.ai/pricing) for details.

### How credits are counted

* A standard request costs **1 credit**.
* Some higher cost sites, such as large consumer marketplaces and certain listing or travel portals, cost **5 credits**.
* A few endpoints that return multiple results bill per result.
* Only successful requests are billed. Failed requests are free.
* Each response reports the exact credits it used (`meta.credits_used`).

The response `meta` object includes `credits_used` and `credits_remaining` so your agent can track usage:

```json theme={null}
{
  "success": true,
  "data": {},
  "meta": {
    "credits_used": 1,
    "credits_remaining": 999
  }
}
```

## Rate limits

Runtime API requests are rate-limited on top of your credit allowance. Limits depend on your plan:

| Tier                   | Per minute | Per hour | Per day | How identity is tracked |
| ---------------------- | ---------- | -------- | ------- | ----------------------- |
| Anonymous (no API key) | -          | 5        | None    | By IP address           |
| Free                   | 20         | 1,000    | 1,000   | By user account         |
| Starter                | 60         | 3,000    | 15,000  | By workspace            |
| Pro                    | 100        | 5,000    | 60,000  | By workspace            |

If you exceed any limit, you'll get a `429 Too Many Requests` response. Rate limits are burst protection; your monthly credit allowance is the main usage budget.

Getting an API key is free. [Sign up](https://hermai.ai/register) and create one in the dashboard.

## Community rewards

You can also earn credits through contributions and community activity:

| Action                  | Credits         |
| ----------------------- | --------------- |
| Make your first request | +50             |
| Refer a friend          | +100 per invite |
| Contribute a schema     | +50 per site    |

Credits accumulate in your account and are shown in the dashboard.

## What counts as a request?

Every call to these endpoints counts against your rate limit:

* `GET /v1/catalog/{domain}` (catalog lookup)
* `POST /v1/fetch` (hosted execution)

These do **not** count against rate limits:

* `GET /v1/schemas` (browse/search the registry)
* `GET /v1/schemas/{site}` (public schema card)
* `GET /v1/schemas/{site}/package` (schema download)
* `GET /v1/trending`, `GET /v1/categories` (discovery surfaces)
* `POST /v1/schemas` (pushing a schema)
* `GET /v1/health`

## Usage dashboard

Your [dashboard](https://hermai.ai/dashboard) shows:

* **Requests today:** how many calls you've made
* **Schema hit rate:** how often your lookups found a cached schema
* **Average latency:** response time across your requests
* **Credits earned:** your accumulated credit balance
* **Activity logs:** per-request detail with URL, status, latency, and timestamp

## Billing and limits

You can sign up and create an API key without a credit card. Rate limits and credits control self-serve usage. If your account does not have enough credits for hosted execution, `POST /v1/fetch` returns `402 INSUFFICIENT_CREDITS`.