Embedding & API

Overview

Lupr exposes a set of public API endpoints for projects that have the badge enabled. These endpoints require no authentication — just enable the badge on your project and start making requests. All endpoints are CORS-enabled so you can call them directly from the browser.

Drop a lightweight feedback widget into any page. The widget loads asynchronously and renders a feedback form tied to your project. All you need is your project ID.

HTML / Script tag

Paste the following snippet before the closing </body> tag of your page.

<!-- Lupr feedback widget -->
<div id="lupr-widget" data-project="YOUR_PROJECT_ID"></div>
<script src="https://app.lupr.dev/widget.js" async></script>

React / Next.js

For React or Next.js apps, use a useEffect hook to inject the widget script dynamically.

"use client";
import { useEffect } from "react";

export function LuprWidget({ projectId }: { projectId: string }) {
  useEffect(() => {
    const script = document.createElement("script");
    script.src = "https://app.lupr.dev/widget.js";
    script.async = true;
    document.body.appendChild(script);
    return () => {
      document.body.removeChild(script);
    };
  }, []);

  return <div id="lupr-widget" data-project={projectId} />;
}

All endpoints are publicly accessible for projects with the badge enabled. No API key or authentication header is required. The base URL is https://app.lupr.dev.

curl "https://app.lupr.dev/api/pitches/clx123abc/widget?sort=votes&limit=5"

{
  "project": {
    "id": "clx123abc",
    "title": "My SaaS Product",
    "badgeEnabled": true
  },
  "stats": {
    "feedbackCount": 42,
    "avgRating": 4.2,
    "pmfScore": 73,
    "topTags": ["ux", "pricing", "feature-request"]
  },
  "feedback": [
    {
      "id": "fb_001",
      "text": "Love the onboarding flow, but pricing page needs work.",
      "authorName": "Jane D.",
      "rating": 4,
      "wouldUse": true,
      "votes": 12,
      "status": "under_consideration",
      "tags": ["pricing", "ux"],
      "createdAt": "2026-02-15T10:30:00Z"
    }
  ]
}

curl "https://app.lupr.dev/api/pitches/clx123abc/badge"

{
  "pitchTitle": "My SaaS Product",
  "pmfScore": 73,
  "feedbackCount": 42,
  "avgRating": 4.2,
  "validated": true
}

curl "https://app.lupr.dev/api/pitches/clx123abc/badge/svg"
# Returns: SVG image (image/svg+xml)

curl -X POST "https://app.lupr.dev/api/pitches/clx123abc/feedback/public" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Great product! The onboarding is smooth but I wish there was a dark mode option.",
    "authorName": "Alex",
    "wouldUse": true
  }'

{
  "id": "fb_002",
  "text": "Great product! The onboarding is smooth but I wish there was a dark mode option.",
  "authorName": "Alex",
  "wouldUse": true,
  "status": "open",
  "createdAt": "2026-03-01T14:22:00Z"
}

Feedback items can be assigned one of seven status labels. These statuses are returned in API responses and displayed in the widget. Use the status query parameter on the widget endpoint to filter by status.

Display a validation badge on your landing page, README, or pitch deck. The badge automatically updates to reflect your current validation score and feedback count.

HTML embed

<a href="https://app.lupr.dev/pitch/clx123abc">
  <img
    src="https://app.lupr.dev/api/pitches/clx123abc/badge/svg"
    alt="Lupr validation badge"
  />
</a>

Markdown embed

[![Lupr](https://app.lupr.dev/api/pitches/clx123abc/badge/svg)](https://app.lupr.dev/pitch/clx123abc)

Badge variants

The badge color changes automatically based on your validation score:

You can serve your public project page and badge from a custom domain instead of app.lupr.dev. This lets you keep embed URLs and badge images on your own brand domain.

Public API endpoints are rate-limited to prevent abuse. Rate limits are applied per IP address.