Leveredge API

Programmatic CRO audits for any public page: conversion score, grounded findings in Hebrew, and an optional AI before/after mockup. Base URL: https://convertoapp.pages.dev

Authentication

Every request carries your key: Authorization: Bearer cvk_.... Keys are subscription-scoped with a monthly audit quota. Request a key through the contact page.

Create an audit

POST /api/v1/audits
{
  "url": "https://example.co.il/landing",
  "premium": false,          // true adds the AI redesign mockup
  "wait": true,              // sync: hold until the analysis is ready (score audits)
  "webhook_url": "https://your.app/hooks/converto",  // optional, fired on completion
  "client_name": "Optional brand name shown on the shared report"
}

Sync mode (wait:true, non-premium): the response returns the full analysis in ~45-90s. Async mode: returns 202 immediately with status:"processing"; poll the audit or receive the webhook. Premium mockups always complete async (typically 1-3 minutes).

Fetch an audit

GET /api/v1/audits/:id

{
  "id": "r1x...", "status": "done", "score": 46,
  "analysis": { "overall_score": 46, "roast_summary": "...", "issues": [...], "priority_fixes": [...] },
  "before_url": "...", "mobile_url": "...", "after_url": "...",
  "share_url": "https://convertoapp.pages.dev/r/r1x...", "pdf_url": ".../pdf"
}

Webhook

When the audit completes we POST the same payload to your webhook_url with header X-Converto-Event: audit.completed. HTTPS only.

Plans

Monthly subscriptions. Quotas reset on the 1st; unused audits do not roll over.

Notes

• One audit call analyzes one page (desktop + mobile capture, grounded findings, 5-second test).
• Every audit ships with a client-shareable report link - your closing asset, hosted by us.
• Quotas reset monthly. 429 means the monthly quota is exhausted.
• A failed audit returns status:"error" with error_kind: "blocked" (bot protection), "refused" (the target's hosting platform answers automated requests without page content) "quality_review" (report failed its quality checks), or "failed" (transient). blocked, refused and quality_review carry retryable:false - retrying the same URL returns the same result. Quota is consumed on all four; write to us for a credit on terminal failures.