Skip to content
TruthVouch Docs

Brand Intelligence API

The Brand Intelligence API monitors how your brand is discussed across the web and audits competitor websites for SEO and content quality.

Overview

Brand Intelligence provides:

  • Brand Monitoring — Track mentions and narratives
  • GEO Auditing — Competitor website analysis
  • Narrative Tracking — How your brand story evolves
  • Competitive Benchmarking — Compare against competitors

Brand Profiles

Create Brand Profile

POST /api/v1/brands

Terminal window
curl -X POST https://api.truthvouch.com/api/v1/brands \
  -H "Authorization: Bearer tv_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "website": "https://acme.com",
    "industryTags": ["saas", "ai", "enterprise"],
    "competitors": [
      {
        "name": "CompetitorA",
        "website": "https://competitora.com"
      },
      {
        "name": "CompetitorB",
        "website": "https://competitorb.com"
      }
    ]
  }'

Get Brand Profile

GET /api/v1/brands/{brandId}

Terminal window
curl https://api.truthvouch.com/api/v1/brands/brand_abc123 \
  -H "Authorization: Bearer tv_live_..."

GEO Auditing (SEO/Content Quality)

Submit Brand Audit

POST /api/v1/brands/{brandId}/audits/geo

Audit your site (or competitor sites) for SEO and content quality:

Terminal window
curl -X POST https://api.truthvouch.com/api/v1/brands/brand_abc123/audits/geo \
  -H "Authorization: Bearer tv_live_..." \
  -d '{
    "targetUrl": "https://acme.com",
    "scanMode": "deep",
    "includeCompetitors": true
  }'

Response:

{
  "data": {
    "auditId": "audit_xyz",
    "status": "processing",
    "estimatedCompletionTime": "2024-03-15T11:00:00Z"
  }
}

Get Audit Results

GET /api/v1/brands/{brandId}/audits/{auditId}

Terminal window
curl https://api.truthvouch.com/api/v1/brands/brand_abc123/audits/audit_xyz \
  -H "Authorization: Bearer tv_live_..."

Response (when complete):

{
  "data": {
    "auditId": "audit_xyz",
    "targetUrl": "https://acme.com",
    "scores": {
      "crawlability": 95,
      "contentQuality": 87,
      "structuredData": 72
    },
    "geoScore": 85,
    "passedChecks": 24,
    "failedChecks": 8,
    "competitiveComparison": {
      "acmeRank": 1,
      "competitors": [
        {
          "name": "CompetitorA",
          "geoScore": 78,
          "contentQuality": 81
        }
      ]
    }
  }
}

Narratives

Track key narratives about your brand:

List Narratives

GET /api/v1/brands/{brandId}/narratives

Terminal window
curl "https://api.truthvouch.com/api/v1/brands/brand_abc123/narratives?status=active" \
  -H "Authorization: Bearer tv_live_..."

Response:

{
  "data": [
    {
      "narrativeId": "narr_1",
      "title": "Enterprise AI leader",
      "mentions": 1234,
      "sentiment": 0.82,
      "trendDirection": "up",
      "topSources": ["forbes.com", "techcrunch.com"],
      "lastUpdated": "2024-03-15T10:00:00Z"
    }
  ]
}

Next Steps