Rate Limits & Usage

Plans

Feature	Trial	Starter ($29/mo)	Pro ($79/mo)	Business ($229/mo)	Scale ($499/mo)
Pages processed / month	100	500	2,000	6,500	15,000
Search queries / month	500	5,000	15,000	50,000	120,000
Knowledge bases	2	3	10	25	100
Documents (total)	10	50	200	500	2,000
Storage	50 MB	500 MB	2 GB	5 GB	20 GB
API rate limit	5 req/s	10 req/s	50 req/s	100 req/s	200 req/s

All plans include the full feature set — embedding, reranking, metadata filtering, and SDKs. Plans differ only in volume limits.

Document limits are per account, across all knowledge bases.

The trial plan is free for 7 days with no credit card required.

Usage Metering

Usage is tracked per billing period:

• Pages processed — Rich documents (PDF, DOCX, PPTX, XLSX, images) use the actual page count. Text-based files (TXT, MD, HTML, CSV, TSV, JSON) estimate at 1 page per ~2,400 bytes.
• Search queries — Each POST /v1/knowledge-bases/:kb_id/search call counts as one query.

Check your current usage at any time:

curl https://api.useragex.com/api/v1/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "data": {
    "current_period_start": "2026-02-01T00:00:00.000Z",
    "current_period_end": "2026-03-01T00:00:00.000Z",
    "plan": "starter",
    "limits": {
      "pages_processed": 500,
      "search_queries": 5000
    },
    "usage": {
      "pages_processed": 342,
      "search_queries": 1205
    },
    "percentage_consumed": {
      "pages": 68,
      "queries": 24
    }
  }
}

Rate Limiting

API rate limits are enforced per-account based on your plan. When exceeded, the API returns:

HTTP 429 Too Many Requests

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded"
  }
}

Best practices:

• Add exponential backoff with jitter to your retry logic
• Use the SDKs, which handle basic retry logic
• If you consistently hit rate limits, upgrade your plan

Usage Limits

When you exceed your monthly pages or queries limit, the API returns:

HTTP 429 Too Many Requests

{
  "error": {
    "code": "USAGE_LIMIT_EXCEEDED",
    "message": "Usage limit exceeded for search_queries. Upgrade your plan or wait for the next billing period.",
    "details": {
      "resource": "search_queries",
      "limit": 5000,
      "used": 5000
    }
  }
}

Usage resets at the start of each billing period.