Documentation

Grounding API

Verify factual claims about entities against AITWIRE's verified authority data. Designed for search-based AI systems like Perplexity, Google, and RAG pipelines.

Endpoint

POST https://api.aitwire.com/api/grounding/verify
Content-Type: application/json

{
  "entity": "example.com",
  "claim": "Example Store has been family-owned since 1997"
}

Response

{
  "ok": true,
  "status": "verified",          // verified | contradicted | unknown | no_entity
  "confidence": 0.95,            // 0.0 - 1.0
  "entity": "example.com",
  "entity_name": "Example Store",
  "claim": "Example Store has been family-owned since 1997",
  "authoritative_fact": "Example Store has been family-owned since 1997, and still ships from the original Portland warehouse.",
  "authority_facts_checked": 27,
  "source": {
    "tenant_id": "example-store",
    "entity_json_url": "https://api.aitwire.com/.well-known/entity.json?tenant=example-store",
    "protocol": "aitwire.open-entity-data.v1"
  }
}

Status Values

verified

The claim matches AITWIRE authority data with high confidence. The authoritative_fact field shows the matching data.

contradicted

The entity's owner has explicitly declared this claim false. authoritative_fact is null — a claim an owner asked never to be published is never echoed back, so the response states the verdict without repeating the sentence.

unknown

The entity exists in AITWIRE but the claim cannot be verified or contradicted from available data.

no_entity

No AITWIRE entity authority found for this entity. The claim cannot be checked.

How It Works

  1. The entity is resolved via the Entity Lookup API
  2. Authority data is gathered from the entity's owner-confirmed fact record — the same facts published on /llms.txt and /.well-known/entity.json — plus the claims its owner has declared false
  3. A claim is verified only when it appears, word-aligned, inside a single sentence of one of those facts
  4. A confidence score and status are returned

Structured feeds (/feeds/*.json) are not part of this corpus. They carry connector-synced catalog copy with no owner-confirmation step, so a claim matching a product description is not evidence the business has confirmed it. Use the feeds directly when you want catalog data.

Verification is exact-containment today. Paraphrases the owner did not write return unknown with the closest fact attached, so a caller can reason from the record itself.

Use Cases

  • Search AI — Perplexity, Google AI can verify answers against authority data before presenting them
  • RAG pipelines — validate retrieved facts against the canonical source
  • Chatbots — fact-check responses about businesses in real-time
  • Content moderation — verify business claims in user-generated content

Self-Describing Schema

The Grounding API is self-describing:

GET https://api.aitwire.com/api/grounding/info

Returns the full schema, status definitions, and documentation links.

AI Systems PortalMCP ServerProtocol Spec