DocsIntroductionQuickstart
Developer Quickstart
Go from discovery to your first API request in minutes. Follow this guide to make your first hoax detection request.
1. Create an API Key
To use the VeriLens API, you will need to authenticate your requests. You can generate an API key from your Developer Dashboard.
Security Note
Keep your API keys secret. Never expose them in client-side code, public repositories, or mobile applications directly. Always invoke our API from your secure backend.
2. Send Your First Request
Once you have your key, send a POST request containing the claim text to our `/v1/verify` endpoint.
bash
curl -X POST https://api.verilens.ai/v1/verify \-H "Authorization: Bearer vl_live_example_key_123" \-H "Content-Type: application/json" \-d '{"text": "Breaking: Scientists discover cure for all cancers using specific deep ocean moss."}'
3. Read the Response
The API will return a structured JSON response containing the analysis verdict, details, and sources used.
json/response.json
{"id": "verify_98218as7a","status": "completed","data": {"text": "Breaking: Scientists discover cure for all cancers using specific deep ocean moss.","is_hoax": true,"confidence_score": 0.942,"verdict": "FALSE_CLAIM","explanation": "No scientific evidence validates ocean moss as a cancer cure. Medical institutions have debunked similar claims.","sources": [{"title": "National Cancer Research Review","url": "https://example.org/cancer-moss-myth"}],"timestamp": "2026-08-28T06:50:00Z"}}
4. Handle Verdicts
Your application should display the verification label according to your user experience rules. E.g., showing warning flags or blur effects over discredited statements.
| Verdict | Definition | Recommended Action |
|---|---|---|
| FALSE_CLAIM | Proven to be completely inaccurate or fabricated. | Warn user, flag, or limit distribution |
| MISLEADING | Contains elements of truth but stripped of context. | Provide a link to verified context/sources |
| TRUE_CLAIM | Accurate information verified by trusted sources. | Mark as checked / verified safe |
| UNVERIFIED | Insufficient reliable context to draw conclusions. | Show neutral state, encourage caution |