CLComparisonListDeveloper API and Webhooks
Developer workflow

Connect website benchmarks to Lavan API keys and webhooks.

ComparisonList exposes one benchmark endpoint for the public product. Behind it, the scanner can use authenticated Lavan API calls, inbound webhook-triggered scans, the Lavan browser engine, or the built-in HTML scanner.

Environment

  • LAVAN_ENABLED: safety gate; set true only when ComparisonList may call Lavan.
  • LAVAN_API_BASE_URL: Lavan API root. The app appends /api/v1 when needed.
  • LAVAN_API_KEY: create authenticated quick scans through /api/v1/scans.
  • LAVAN_PROJECT_ID: optional; when present, create scans inside that fixed project.
  • LAVAN_INBOUND_WEBHOOK_TOKEN: trigger scans through Lavan inbound webhooks when a full API key is not needed.
  • LAVAN_TEST_ENGINE_URL: direct browser engine fallback for local integration work.

Request

POST https://comparisonlist.com/api/benchmark
Content-Type: application/json

{
  "ownSite": "https://your-shop.nl",
  "competitors": ["https://competitor-a.nl", "https://competitor-b.nl"],
  "locale": "en"
}
# -> { "runId": "..." }   poll GET https://comparisonlist.com/api/benchmark/{runId}
# MCP server: https://api.comparisonlist.com/mcp
Automation capabilities

Designed for agencies, CRM workflows and deployment checks.

Customer API keys

Let agencies and technical customers trigger benchmarks from their own systems without sharing dashboard access.

Inbound scan webhooks

Accept signed webhook calls from deployment tools, website monitors or lead-generation workflows.

Outbound result webhooks

Send benchmark completed events to CRM, Slack, Make, n8n or an agency client portal.

Paydar implementation queue

Route high-intent benchmark gaps into accessibility remediation, expert review and monitoring.