REST API

BiasRubric API

Add AI-powered media bias scoring to any app.

Authentication

Pass your API key as a Bearer token in the Authorization header on every request.

Authorization: Bearer YOUR_API_KEY

POST/api/v1/score

Analyze a URL or text passage. Returns a 4-model consensus bias score.

Request body

urlstringA publicly accessible article URL to fetch and analyze.

textstringRaw article text to analyze directly. Use when URL is paywalled.

Provide either url or text - not both required.

Example request

curl -X POST https://www.biasrubric.com/api/v1/score \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

Example response

{
  "success": true,
  "data": {
    "consensusScore": 2.4,
    "label": "Slight Left",
    "models": {
      "claude":  { "score": 2.3, "confidence": 0.92, "reasoning": "...", "signals": ["..."] },
      "gpt":     { "score": 2.5, "confidence": 0.88, "reasoning": "...", "signals": ["..."] },
      "gemini":  { "score": 2.4, "confidence": 0.85, "reasoning": "...", "signals": ["..."] },
      "grok":    { "score": 2.4, "confidence": 0.84, "reasoning": "...", "signals": ["..."] }
    },
    "cached": false,
    "checkedAt": "2026-03-23T14:00:00.000Z"
  }
}

Response fields

Field	Type	Description
consensusScore	number	1-5 averaged across all models. 1 = strong left, 3 = center, 5 = strong right.
label	string	Human-readable label: Strong Left · Slight Left · Center · Slight Right · Strong Right
models.*.score	number	Individual model score on the 1-5 scale.
models.*.confidence	number	Model's confidence in its score (0-1).
models.*.reasoning	string	One-sentence explanation from the model.
models.*.signals	string[]	List of bias signals detected (e.g. "loaded language", "source selection").
cached	boolean	True if result was served from cache (same URL/text analyzed before).
checkedAt	string	ISO 8601 timestamp of when the analysis was first performed.

GET/api/v1/status

Check your current plan, usage count, and monthly limit.

Example request

curl https://www.biasrubric.com/api/v1/status \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "success": true,
  "data": {
    "plan": "PUBLISHER",
    "checkCount": 42,
    "monthlyLimit": 1500,
    "domain": "yourdomain.com",
    "active": true
  }
}

Pricing & Limits

Free Account

10 / day

Publisher Plan

$29 / mo

1,500 checks/month with a dedicated Publisher API key. Priority analysis queue.

Get Your API Key

Powering bias scores on DailyComposite.com