Verify API

Cross-reference claims against multiple sources with credibility scoring and evidence analysis.

Verify Claim

POST /api/v1/verify/claim

Verify a factual claim by searching and analyzing multiple sources.

Body Parameters

Parameter	Type	Default	Description
`claim`	string	required	The claim to verify
`depth`	string	`"quick"`	`"quick"` or `"thorough"`
`include_sources`	boolean	`true`	Include source evidence

Example Request

curl -X POST 'https://api.unsearch.dev/api/v1/verify/claim' \
  -H 'X-API-Key: sk_live_xxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "claim": "GPT-4 has 1.8 trillion parameters",
    "depth": "thorough",
    "include_sources": true
  }'

Response

{
  "claim": "GPT-4 has 1.8 trillion parameters",
  "verdict": "unverifiable",
  "confidence": 30.0,
  "summary": "OpenAI has not officially disclosed the parameter count of GPT-4. The 1.8 trillion figure comes from unverified leaks.",
  "supporting_evidence": [
    {
      "title": "Leaked GPT-4 Details",
      "url": "https://example.com/leak",
      "snippet": "According to leaked documents...",
      "stance": "supporting",
      "credibility_score": 0.4
    }
  ],
  "contradicting_evidence": [
    {
      "title": "OpenAI's Official Statement",
      "url": "https://example.com/openai",
      "snippet": "We do not disclose model architecture details...",
      "stance": "contradicting",
      "credibility_score": 0.95
    }
  ],
  "key_facts": [
    "OpenAI has not confirmed GPT-4's parameter count",
    "The 1.8T figure originated from an unverified source"
  ],
  "nuances": "While the exact parameter count is unconfirmed, GPT-4 is widely believed to be a mixture-of-experts model.",
  "sources_checked": 12,
  "verification_time_ms": 3200
}

Verdict values: true, false, partially_true, unverifiable, misleading

Check Source Credibility

POST /api/v1/verify/source

Evaluate the credibility of a web source.

Body Parameters

Parameter	Type	Default	Description
`url`	string	required	URL to evaluate

Example Request

curl -X POST 'https://api.unsearch.dev/api/v1/verify/source' \
  -H 'X-API-Key: sk_live_xxxxx' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://reuters.com" }'

Response

{
  "domain": "reuters.com",
  "credibility_score": 92.0,
  "category": "news",
  "bias_rating": "center",
  "factual_reporting": "very_high",
  "notes": "Reuters is a major international news agency known for factual reporting.",
  "last_updated": "2025-03-01T00:00:00Z"
}

Category values: news, academic, government, commercial, personal, satire, unknown

Bias ratings: far_left, left, center_left, center, center_right, right, far_right, unknown

Factual reporting: very_high, high, mostly_factual, mixed, low, very_low, unknown

Batch Verification

POST /api/v1/verify/batch

Verify multiple claims at once.

Body Parameters

Parameter	Type	Default	Description
`claims`	string[]	required	Claims to verify (max 10)

Response

{
  "job_id": "job_abc123",
  "status": "completed",
  "claims_count": 3,
  "results": [
    {
      "claim": "The Earth is 4.5 billion years old",
      "verdict": "true",
      "confidence": 95.0,
      "summary": "Scientific consensus strongly supports this."
    }
  ],
  "poll_url": "/api/v1/verify/batch/job_abc123"
}

For large batches, the response may return "status": "processing" — poll the poll_url to get results.

Verify API

On this page