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 /verify

No authentication required. Public endpoint.

curl -X POST https://trust.truthvouch.com/api/v1/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://trust.truthvouch.com/api/v1/verify \
  -H "Content-Type: application/json" \
  -d '{
    "claim": "The Earth orbits the Sun",
    "mode": "deep"  # Most thorough
  }'

Batch Verify (Public)

POST /verify/batch

Verify multiple claims at once:

curl -X POST https://trust.truthvouch.com/api/v1/verify/batch \
  -H "Content-Type: application/json" \
  -d '{
    "claims": [
      "Paris is in France",
      "Tokyo is in Japan",
      "London is in Germany"
    ],
    "mode": "standard"
  }'

Response:

{
  "data": {
    "results": [
      {
        "claim": "Paris is in France",
        "trustScore": 0.97,
        "verdict": "accurate"
      },
      {
        "claim": "Tokyo is in Japan",
        "trustScore": 0.98,
        "verdict": "accurate"
      },
      {
        "claim": "London is in Germany",
        "trustScore": 0.01,
        "verdict": "inaccurate"
      }
    ],
    "processingTimeMs": 456
  }
}

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 has generous free rate limits:

Requests/min: 600 (no key required!)
Burst: 1000 over 10 seconds
Batch size: Max 100 claims per request

No authentication needed, no signup required. Just start calling.

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://trust.truthvouch.com/api/v1/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://trust.truthvouch.com/api/v1/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"
]

results = requests.post(
    "https://trust.truthvouch.com/api/v1/verify/batch",
    json={"claims": claims, "mode": "deep"}
).json()

for result in results["data"]["results"]:
    print(f"{result['claim']}: {result['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.