Trust API (Public)

The Trust API is a public, free-tier fact-checking service that requires no authentication. Automatically verify any claim against your knowledge base without an API key.

API Playground

Base URL

https://trust.truthvouch.com/api/v1

Verify Claim (Public)

POST /api/v1/public/verify

No authentication required. Public endpoint.

curl -X POST https://api.truthvouch.com/api/v1/public/verify \
  -H "Content-Type: application/json" \
  -d '{
    "claim": "Paris is the capital of France",
    "mode": "standard"
  }'

Response:

{
  "data": {
    "claim": "Paris is the capital of France",
    "trustScore": 0.97,
    "verdict": "accurate",
    "sources": [
      {
        "title": "Paris (Capital of France)",
        "url": "https://en.wikipedia.org/wiki/Paris",
        "confidence": 0.99
      }
    ],
    "processingTimeMs": 234
  }
}

Verification Modes

Mode	Speed	Cost	Best For
`spot_check`	Fast	Free	Quick sampling
`standard`	Medium	Free	General purpose
`deep`	Slow	Free	Critical claims

curl -X POST https://api.truthvouch.com/api/v1/public/verify \
  -H "Content-Type: application/json" \
  -d '{
    "claim": "The Earth orbits the Sun",
    "mode": "deep"
  }'

Response Fields

Field	Type	Description
`claim`	string	The original claim
`trustScore`	number	0.0-1.0 (1.0 = highly accurate)
`verdict`	string	accurate, inaccurate, unclear, or disputed
`sources`	array	Supporting sources with URLs
`processingTimeMs`	number	Milliseconds to process

Rate Limits (Public)

The Trust API is rate limited by IP address for free tier access:

Free Tier (Unauthenticated): 10 requests per hour per IP address
Authenticated Users: Higher rate limits based on subscription plan
- Standard: 1,000 requests per hour
- Business: 10,000 requests per hour
- Enterprise: Custom limits

To get higher limits, create an API key in your account settings and include it in the Authorization header.

Error Handling

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "claim is required",
    "statusCode": 400
  }
}

Use Cases

Real-Time Fact-Checking

In a chatbot, verify responses before showing to users:

import requests

response_text = "The Eiffel Tower is 330 meters tall"
result = requests.post(
    "https://api.truthvouch.com/api/v1/public/verify",
    json={"claim": response_text, "mode": "standard"}
).json()

if result["data"]["trustScore"] < 0.7:
    print(f"Warning: Low accuracy ({result['data']['trustScore']})")

Content Moderation

Check user-generated claims before publishing:

user_claim = "This product cures cancer"
result = requests.post(
    "https://api.truthvouch.com/api/v1/public/verify",
    json={"claim": user_claim}
).json()

if result["data"]["verdict"] == "inaccurate":
    # Flag for review before publication
    flag_for_moderation(user_claim)

Research Validation

Verify facts during research:

claims = [
    "COVID-19 vaccines prevent severe illness",
    "Climate change is real",
    "Humans landed on the moon in 1969"
]

# Verify each claim individually
for claim in claims:
    result = requests.post(
        "https://api.truthvouch.com/api/v1/public/verify",
        json={"claim": claim, "mode": "deep"}
    ).json()
    print(f"{claim}: {result['data']['verdict']}")

Limitations

Public knowledge only — Can’t verify proprietary/internal facts
Historical only — Real-time events take 24-48 hours to index
English only — Currently supports English claims
No authentication — Can’t verify claims from your private database

For proprietary data verification, use the Governance Firewall with authentication.