✦ Publisher Integration

Embed a quality badge
in one line

Add a dynamic, colour-coded Preprints.ai grade badge to any paper page. Badges update automatically. No API key required for display.

Badge Styles

Colour-coded by grade

Green for strong evidence, amber for incomplete, red for concern. A single glance communicates trustworthiness.

Grade A or B — Strong evidence

preprints.ai B4 preprints.ai A5

Convincing or compelling evidence with high novelty

Grade C — Mixed quality

preprints.ai C3 preprints.ai C1

Incomplete evidence or design concerns identified

Grade D or E — Significant concerns

preprints.ai D2 preprints.ai E1

Serious methodological, integrity, or validity concerns

Pending / Not yet assessed

preprints.ai pending preprints.ai not assessed

Grey badges are shown before assessment completes

Badge Generator

Generate your embed code

Enter a DOI below to get the exact embed code for that paper. The badge will show "not assessed" if the paper hasn't been reviewed yet.

Badge Generator Assess a Paper First →

Paper DOI

Live Preview:

← Updates live as you type

HTML (with link)

HTML (image only)

Markdown

reStructuredText (RST)

Integration Guide

Add to your platform

Add badges to preprint server landing pages, reference manager plugins, journal submission portals, or search result listings.

HTML / Jinja / PHP templates

                html
                
            
<!-- Add this anywhere on the paper page -->
<a href="https://preprints.ai/report/{{ paper.doi }}"
   target="_blank" rel="noopener">
  <img
    src="https://preprints.ai/badge/{{ paper.doi }}"
    alt="Preprints.ai quality grade"
    height="20"
    loading="lazy"
  />
</a>

JavaScript — fetch grade programmatically

                javascript
                
            
const doi = '10.1101/2025.01.28.123456';
const resp = await fetch(
  `https://preprints.ai/v2/score/${doi}`,
  { headers: { 'X-API-Key': YOUR_API_KEY } }
);
if (resp.ok) {
  const data = await resp.json();
  console.log(data.grade);     // "B4"
  console.log(data.badge_url); // "https://preprints.ai/badge/..."
}

Python

                python
                
            
import httpx

doi = "10.1101/2025.01.28.123456"
resp = httpx.get(
    f"https://preprints.ai/v2/score/{doi}",
    headers={"X-API-Key": "pak_your_key"},
)
data = resp.json()
print(data["grade"])      # "B4"
print(data["badge_url"])  # "https://preprints.ai/badge/..."

Colour Reference

What the colours mean

The badge colour maps directly to the integrity letter grade (A–E), not the composite A5–E1 score.

Grade	Colour	Hex	Meaning
A	Deep green	#15803d	Compelling evidence — no integrity concerns
B	Green	#16a34a	Convincing evidence — minor gaps only
C	Amber	#d97706	Incomplete evidence or design limitations
D	Red	#dc2626	Inadequate evidence or serious concerns
E	Deep red	#b91c1c	Critical integrity or validity issues
Pending	Grey	#6b7280	Assessment in progress or not yet submitted

Technical Details

Badge endpoint reference

The badge endpoint is public — no API key required to display a badge. The SVG is cached for 24 hours and updated automatically when an assessment changes.

GET https://preprints.ai/badge/{doi}

Returns SVG image (image/svg+xml)
Cache 7 days for assessed papers; 1 hour for "not assessed"
Auth None required — badge display is public
X-Grade header Response includes X-Grade: B4 for programmatic use
DOI formats Accepts raw DOIs, arxiv:XXXX, full URLs

Important:

Badges reflect automated machine assessments. All grades require human expert review before acting on them. See Methodology for details on what is and isn't assessed.

Embed a quality badgein one line