Visibility & discovery

Read public visibility evidence for any approved site, explore cached referring domains, discover trusted sites, and propose relevant link exchanges.

Create my API key Back to the overview

Score data

GET/dr/:domain

Get Domain Rating for any domain

Returns Domain Rating for any domain, including sites outside VerifiedDR. Check prospects, competitors or link targets before tracking them.

Same call in the CLIvdr authority:dr example.com

Request

curl https://verifieddr.com/api/v1/dr/example.com \
  -H "Authorization: Bearer vdr_your_api_key"

Response

{
  "dr": { "domain": "example.com", "dr": 62, "source": "verifieddr", "listed": true, "slug": "example-com" }
}

This route returns DR. For a tracked site, call /lookup/:domain for TrueDR, trust, and traffic checks.
Subdomains and URLs resolve to the registrable domain: blog.example.com/post returns example.com.
Results are cached per domain, but every call still spends one quota unit.

GET/site-check/:domain

Check whether a site is real

Returns the stored fraud verdict for a submitted site. It combines a homepage render check, domain age, organic-keyword footprint, and backlink spam signals into real, suspicious, shell, or unreachable, with the reasons spelled out. Built for vetting link targets and exchange candidates before trading anything.

Request

curl https://verifieddr.com/api/v1/site-check/example.com \
  -H "Authorization: Bearer vdr_your_api_key"

Response

{
  "siteCheck": {
    "domain": "example.com",
    "verdict": "real",
    "reasons": [],
    "reachable": true,
    "https": true,
    "title": "Example",
    "shell": { "isShell": false, "visibleTextChars": 4200, "textRatio": 0.21, "outboundLinks": 8 },
    "domainAgeYears": 6.3,
    "rankedKeywords": 142,
    "referringDomains": 89,
    "backlinks": 900,
    "spamScore": 12
  }
}

This route reads saved reports for listed sites. It returns 404 for a new domain. Create a report through POST /sites with siteCheck: true.
The verdict is plain rules over the returned signals, so you can audit every decision from the reasons array.
A shell verdict means the homepage renders no meaningful content without JavaScript.
Provider signals are nullable: a missing signal weakens evidence but never fails the request.
Every call spends one quota unit.

GET/lookup/:domain

Look up a site's scores

Returns DR, TrueDR, trust score, confidence, traffic validation, backlink evidence, changes, and public links for any approved site. The private per-signal trust breakdown is intentionally excluded.

Same call in the CLIvdr authority:lookup example.com

Request

curl https://verifieddr.com/api/v1/lookup/example.com \
  -H "Authorization: Bearer vdr_your_api_key"

Response

{
  "lookup": {
    "domain": "example.com",
    "slug": "example-com",
    "authority": { "dr": 62, "trueDr": 57, "trustScore": 71, "confidence": "high", "trafficValidated": true },
    "changes": { "drWeeklyChange": 1, "trueDrWeeklyChange": 2, "trafficChange": 8 },
    "evidence": { "traffic": 42000, "referringDomains": 510, "backlinks": 9200 },
    "verified": true
  }
}

GET/map/:domain

Get the Trust Map

Returns up to 60 cached referring domains with DR, link status, importance, and spam risk. It never triggers a paid backlink fetch.

Same call in the CLIvdr map example.com --json

Request

curl https://verifieddr.com/api/v1/map/example.com \
  -H "Authorization: Bearer vdr_your_api_key"

Response

{
  "map": {
    "site": { "domain": "example.com", "dr": 62, "verified": true },
    "totalDomains": 510,
    "domains": [{ "domain": "source.example", "dr": 78, "backlinks": 2, "linkType": "dofollow", "status": "live", "importance": 88, "spamScore": 0 }]
  }
}

A cold cache returns 503 with instructions to open the site's Trust Map or wait for the next refresh.

GET/snippets/:domain

Get badge and embed snippets

Returns public page, badge, and OG links plus ready-to-paste HTML, dark badge, TrueDR badge, Markdown, and share text.

Same call in the CLIvdr badge:snippets example.com

Request

curl https://verifieddr.com/api/v1/snippets/example.com \
  -H "Authorization: Bearer vdr_your_api_key"

Response

{
  "page": "https://verifieddr.com/website/example-com",
  "badge": "https://verifieddr.com/badge/example-com.svg",
  "html": "<a href=...>...</a>",
  "markdown": "[![VerifiedDR](...)](...)"
}

Discovery and link exchanges

GET/find

Discover trusted sites

Find approved sites ranked by TrueDR and DR. Filter with category, minTrueDr, minDr, trafficValidated, includeUnverified, and limit (maximum 50). Add exchangesFor for site-specific exchange matches.

Same call in the CLIvdr discover:find --category ai --min-truedr 50

Request

curl "https://verifieddr.com/api/v1/find?category=ai&minTrueDr=50&trafficValidated=true&limit=10" \
  -H "Authorization: Bearer vdr_your_api_key"

Response

{
  "find": {
    "filters": { "category": "ai", "minTrueDr": 50, "limit": 10 },
    "sites": [{ "domain": "trusted.example", "authority": { "dr": 64, "trueDr": 59 } }]
  }
}

GET/find?exchangesFor=:domain

Find link exchange matches

Returns verified websites open to one relevant editorial link each. Every account can browse matches. Monthly limits start when you propose an exchange.

Same call in the CLIvdr exchanges example.com

Request

curl "https://verifieddr.com/api/v1/find?exchangesFor=example.com&limit=10" \
  -H "Authorization: Bearer vdr_your_api_key"

Response

{
  "exchanges": {
    "domain": "example.com",
    "candidates": [{ "domain": "match.example", "slug": "match-example", "exchange": { "type": "Link exchange", "reason": "Shared audience. Propose one relevant editorial link each." } }]
  }
}

POST/find

Propose a link exchange

Previews or sends a one-link-each proposal through VerifiedDR without exposing the other owner's email. The source site must belong to the API-key owner.

Same call in the CLIvdr exchanges example.com --contact match-example --dry-run

Request

curl https://verifieddr.com/api/v1/find \
  -X POST \
  -H "Authorization: Bearer vdr_your_api_key" \
  -H "Content-Type: application/json" \
					-d '{"exchangesFor":"example.com","target":"match-example","destinationUrl":"https://example.com/guide","dryRun":true}'

Response

{
  "exchange": {
	    "dryRun": true,
	    "sent": false,
	    "to": { "domain": "match.example", "slug": "match-example" },
	    "subject": "Link exchange between example.com and match.example",
	    "message": "Proposal: I add a relevant editorial link to your site, and you add one to mine...",
    "quota": { "used": 1, "limit": 20, "plan": "Pro" }
  }
}

A dry run can generate the standard proposal when subject and message are omitted. It never sends email.
The owner approves the target, subject, and message before the send.
A spent contact allowance returns 402 with upgradeUrl, requiredPlan, and blockedFeature.

Visibility & discovery

Score data

Get Domain Rating for any domain

Check whether a site is real

Look up a site's scores

Get the Trust Map

Get badge and embed snippets

Discovery and link exchanges

Discover trusted sites

Find link exchange matches

Propose a link exchange

Build your next trusted connection