← Beta RAG

Documentation

One endpoint. POST a query. Get results.

Endpoint

POST https://betarag.com/api

Authentication

Include your API key as an x-api-key header.

x-api-key: brag_your_key_here

Request

Field	Type	Required	Description
query	string	Yes	Your search query
count	integer	No	Results to return (1-50, default 10)
threshold	float	No	Min similarity (0-1, default 0)
mode	string	No	auto, precision, balanced, explore

Example

curl https://betarag.com/api \
  -H "Content-Type: application/json" \
  -H "x-api-key: brag_your_key_here" \
  -d '{"query": "recommendation systems", "count": 5}'

Response

{
  "product": "Beta RAG",
  "query": "recommendation systems",
  "mode": "balanced",
  "count": 5,
  "latency_ms": 342,
  "results": [
    {
      "name": "Result Name",
      "content": "...",
      "score": 0.847,
      "similarity": 0.812,
      "metadata": {
        "relevance_weight": 0.8,
        "depth": 3,
        "category": 2
      }
    }
  ],
  "rate_limit": {
    "minute_remaining": 9,
    "day_remaining": 99,
    "tier": "free"
  }
}

Modes

Mode	Best For
auto	Most queries — detects optimal strategy
precision	Exact lookups
balanced	General search
explore	Discovery, cross-domain

Rate Limits

Tier	Per Minute	Per Day	Price
Free	10	100	$0
Builder	60	5,000	$49/mo
Oracle	600	Unlimited	$199/mo

Errors

Status	Meaning
401	Missing or invalid API key
429	Rate limit exceeded
400	Invalid request