Developer Portal

Integrate TrueLens into your applications

Quick Start

1

Get API Key

Sign up and generate your API key from the dashboard

2

Make a Request

Send a POST request with your content to analyze

3

Get Results

Receive trust score, verdict, and detailed signal breakdown

Code Examples

curl -X POST https://api.truelens.app/v1/scans \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "url": "https://example.com/article",
    "contentType": "url"
  }'

API Endpoints

POST/api/v1/scans

Submit content for analysis

Request Body

{
  "url": "https://example.com",
  "contentType": "url"
}

Response

{
  "success": true,
  "scan": {
    "id": "scan_abc123",
    "trustScore": 82,
    "verdict": "Authentic",
    "signals": [...]
  }
}
GET/api/v1/scans/:id

Retrieve scan results by ID

Response

{
  "scan": {
    "id": "scan_abc123",
    "trustScore": 82,
    "verdict": "Authentic",
    "signals": [...],
    "scanDuration": 3.2
  }
}
POST/api/v1/documents

Upload a document for verification

Request Body

FormData with 'file' field

Response

{
  "success": true,
  "document": {
    "id": "doc_xyz789",
    "hash": "a3f2b8c9...",
    "trustScore": 92,
    "status": "verified"
  }
}
POST/api/v1/verify

Verify a document by hash or scan ID

Request Body

{
  "hash": "a3f2b8c9d1e4f5..."
}

Response

{
  "verified": true,
  "message": "Document verified",
  "document": { ... }
}
GET/api/v1/health

Health check endpoint

Response

{
  "status": "healthy",
  "version": "1.0.0"
}

API Pricing

Free

₹0/month
  • 50 scans/month
  • Text + URL analysis
  • 7-day history
  • Community support
Most Popular

Pro

₹499/month
  • 5,000 scans/month
  • All signals incl. image + document
  • 1 year history
  • 1,000 API calls/day
  • Priority support

Enterprise

Custom
  • Unlimited scans
  • SLA guarantee
  • Dedicated support
  • On-premise ML option
  • Custom webhook