Tools

Start an async trust-signals scan

Changed on

Start an asynchronous trust-signal analysis for a public domain. Returns a tier verdict (comprehensive / substantial / moderate / minimal) with a 0-100 score and a per-category breakdown across five buyer-concern areas: enterprise readiness, third-party validation, social proof, brand authority, and risk reversal. Also surfaces suspicious patterns (e.g. unverified compliance claims, count-vs-logo mismatches, unlinked press mentions) and gaps versus tier benchmarks. Returns sub-second with item: { id, status: "queued", createdAt, expiresAt } — poll GET /v1/tools/trust-signals/scans/{scanId} until status is completed or failed. Most scans complete in seconds; heavy-render sites can take up to ~90 seconds. Result and error payloads are persisted for 24h, after which the scan auto-deletes and GET returns 404. No project required. Suitable for sales discovery, due-diligence flows, and competitive credibility audits — and the only supported shape for MCP clients (Cursor / Claude Desktop hardcode 60-second tool-call timeouts).

post/v1/tools/trust-signals/scans

Request

  • Base URL: https://api.competlab.com
  • URL: https://api.competlab.com/v1/tools/trust-signals/scans
  • Auth: API key in header CL-API-Key

Request body

domainstring required

Target domain to scan for trust signals. Accepts a bare hostname or a full URL — normalized (lowercased, scheme and path stripped) before scanning.

Example request

{
  "domain": "stripe.com"
}

Response

Example response

{
  "item": {
    "id": "6638e9a1b2c3d4e5f6a7b8c9",
    "status": "queued",
    "createdAt": "2026-05-17T14:30:00.000Z",
    "expiresAt": "2026-05-18T14:30:00.000Z"
  }
}

Changes

    • info

      added the non-success response with the status

    • warning

      added the new nothing_to_return enum value to the / response property for the response status

    • warning

      added the new paging_requires_compact_view enum value to the / response property for the response status

    • warning

      added the new paging_requires_summary enum value to the / response property for the response status