Trust Scores API

Access your brand's trust scores across AI agent platforms. Trust scores influence how agents rank and recommend your products.

Scope: trust:read

Management API preview

Trust scoring runs live in the Cresva backend (composite 0-100 from real signals). The current trust score for a storefront is exposed through the Storefront API at GET /api/storefront/[brandId]/trust. The brand-facing history and time-series endpoints documented here ship with the public Management API release.

GET/trust

Retrieve current trust scores including overall score, tier, and per-platform breakdown with trends.

bash

curl https://api.cresva.ai/api/storefront/[brandId]/trust \
  -H "Authorization: Bearer cresva_ak_..."

javascript

const response = await fetch("https://api.cresva.ai/api/storefront/[brandId]/trust", {
  headers: {
    Authorization: "Bearer " + process.env.CRESVA_API_KEY,
  },
});

const { data } = await response.json();

Example Response

JSON

{
  "data": {
    "overallScore": 92,
    "tier": "Gold",
    "platforms": [
      { "name": "chatgpt", "score": 94, "trend": "up" },
      { "name": "perplexity", "score": 91, "trend": "stable" },
      { "name": "claude", "score": 89, "trend": "up" }
    ],
    "lastUpdated": "2026-03-28T00:00:00Z"
  }
}

GET/trust/history

Retrieve trust score changes over time. Useful for tracking improvements and identifying dips.

Query Parameters

sincestringISO 8601 start date

untilstringISO 8601 end date

bash

curl "https://api.cresva.ai/api/storefront/[brandId]/trust/history?since=2026-01-01T00:00:00Z&until=2026-03-28T00:00:00Z" \
  -H "Authorization: Bearer cresva_ak_..."

javascript

const response = await fetch(
  "https://api.cresva.ai/api/storefront/[brandId]/trust/history?since=2026-01-01T00:00:00Z&until=2026-03-28T00:00:00Z",
  {
    headers: {
      Authorization: "Bearer " + process.env.CRESVA_API_KEY,
    },
  }
);

const { data } = await response.json();

Example Response

JSON

{
  "data": [
    { "date": "2026-03-28", "score": 92 },
    { "date": "2026-03-21", "score": 90 },
    { "date": "2026-03-14", "score": 88 },
    { "date": "2026-03-07", "score": 87 }
  ]
}

Trust object

JSON

{
  "overallScore": 92,
  "tier": "Gold",
  "platforms": [
    { "name": "chatgpt", "score": 94, "trend": "up" },
    { "name": "perplexity", "score": 91, "trend": "stable" }
  ],
  "lastUpdated": "2026-03-28T00:00:00Z"
}