Raina API Reference
Integrate content authenticity verification into your applications with our REST API.
Getting Started
Quick Start
Make your first API call in minutes. Here's how to verify text content:
const response = await fetch('https://rainaventure.com/api/score', {
method: 'POST',
headers: {
'Authorization': 'Bearer rn_YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
contentType: 'text',
content: 'Text content to verify...',
scanMode: 'standard'
})
});
const result = await response.json();
console.log(result.trustScore, result.uasResult);Enterprise Onboarding
API Key Setup
rn_ and should be kept secure. Rotate keys regularly for security.Rate Limits & Quotas
IP Whitelisting
Authentication
All API requests require authentication. Raina accepts the key via either header — x-api-key is the canonical form and Authorization: Bearer is provided for compatibility with standard HTTP clients. Keys are prefixed with rn_.
Authorization: Bearer rn_YOUR_API_KEY
# or
x-api-key: rn_YOUR_API_KEYEndpoints
All endpoints are served from the same origin as the dashboard (e.g. https://rainaventure.com). Paths are unversioned; versioning will be announced via deprecation headers before any breaking change.
/api/score/api/media-upload/api/media-scan/api/sources/api/sources/lookup/api/usage/current/api/scansError Handling
The API uses standard HTTP status codes and returns structured error bodies via sendApiError with an error, code, and requestId field.
400Bad Request - Invalid parameters401Unauthorized - Invalid or missing API key403Forbidden - Key lacks required capability (scan, read, export)429Rate Limited - See backoff example below503Service Unavailable - Safe mode or maintenance; retry later500Server Error - Retry with exponential backoff429 response & backoff
HTTP/1.1 429 Too Many Requests
Retry-After: 2
Content-Type: application/json
{
"error": "Rate limit exceeded",
"code": "RATE_LIMITED",
"limit": 35,
"used": 35,
"requestId": "req_..."
}Honor Retry-After. For 500/503, retry with exponential backoff (e.g. 1s, 2s, 4s, 8s, jittered, max 5 attempts). Do not retry 400/401/403; fix the request.
Webhooks
Configure webhooks to receive real-time notifications when trust traces complete. Events include:
- trace.completed
- trace.failed
- usage.threshold.reached
SDKs & Libraries
Enterprise
Enterprise features include advanced capabilities for high-volume deployments:
Batch Processing
Submit up to 1,000 items per request for efficient bulk verification.
Async Verification
Queue long-running trust traces and receive results via webhook.
Custom Integrations
Work with our team to build custom API endpoints for your workflow.
SLA Guarantees
99.9% uptime SLA with financial credits for any downtime.