Sites & monitoring

Manage the sites on your account, read private TrueDR details, monitor changes, export evidence, and review severe spam-link risk.

Create my API key Back to the overview

Sites

GET/sites

List your sites

Returns every site on the API-key owner's account with current DR, TrueDR, traffic, verification, and latest backlink totals.

Same call in the CLIvdr sites:list

Request

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

Response

{
  "sites": [{
    "slug": "example-com", "url": "https://example.com", "dr": 42,
    "trueDr": 37, "organicTraffic": 8600, "verified": true,
    "referringDomains": 120, "backlinks": 540
  }]
}

POST/sites

Submit a site

Adds a site to your account and queues DR, traffic, metadata, and TrueDR enrichment. Use one to three values returned by the categories endpoint.

Same call in the CLIvdr sites:submit example.com --title "Example" --category saas

Request

curl https://verifieddr.com/api/v1/sites \
  -X POST \
  -H "Authorization: Bearer vdr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"example.com","title":"Example","categories":["saas"]}'

Response

{
  "accepted": true,
  "created": true,
  "status": "queued",
  "site": { "slug": "example-com", "url": "https://example.com" },
  "siteCheck": null,
  "links": { "site": "/api/v1/sites/example-com", "trueDr": "/api/v1/sites/example-com/truedr" }
}

Add siteCheck: true to also run the site reality check (shell, PBN, and spam heuristics) at submit time. The report comes back in siteCheck and stays fetchable from GET /site-check/:domain, which itself never runs checks.

GET/sites/:slug

Get one site

Returns current metrics plus stored DR and traffic history. Owned sites resolve first. Approved public sites return public data with owned: false.

Same call in the CLIvdr sites:get example.com

Request

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

Response

{
  "site": { "slug": "example-com", "dr": 42, "trueDr": 37 },
  "owned": true,
  "drHistory": [{ "date": "2026-07-20", "dr": 42, "trueDr": 37 }],
  "trafficHistory": [{ "date": "2026-07", "traffic": 8600 }]
}

GET/sites/:slug/truedr?detailed=true

Get private TrueDR details

Reads the stored score for an owned site. detailed=true adds the private per-signal breakdown and ranked recommendations; it never triggers a recompute.

Same call in the CLIvdr sites:truedr example.com --detailed

Request

curl "https://verifieddr.com/api/v1/sites/example.com/truedr?detailed=true" \
  -H "Authorization: Bearer vdr_your_api_key"

Response

{
  "slug": "example-com", "trueDr": 37, "confidence": "high", "status": "ready",
  "breakdown": { "backlinkTrustScore": 37, "signals": [] },
  "recommendations": []
}

Before the first score is ready, trueDr is null and status is pending.

Monitoring and export

GET/monitor

Monitor visibility changes

Returns scores, deltas, new and lost referring domains, traffic validation, trust alerts, and a plain-English summary for all owned sites or one domain.

Same call in the CLIvdr sites:monitor example.com --daily

Request

curl "https://verifieddr.com/api/v1/monitor?domain=example.com&daily=true" \
  -H "Authorization: Bearer vdr_your_api_key"

Response

{
  "monitor": {
    "cadence": "daily",
    "sites": [{ "domain": "example.com", "authority": { "dr": 42, "trueDr": 37 }, "alerts": [], "summary": "TrueDR improved by 2." }]
  }
}

GET/export/:domain

Export one site

Combines the compact owned-site record, full public score payload, and all badge snippets for scripts, CI, dashboards, and client reports.

Same call in the CLIvdr sites:export example.com

Request

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

Response

{
  "export": {
    "site": { "slug": "example-com", "dr": 42, "trueDr": 37 },
    "authority": { "domain": "example.com", "authority": { "dr": 42, "trueDr": 37 } },
    "snippets": { "html": "<a href=...>...</a>" }
  }
}

Verification

POST/verify

Verify a badge

Fetches one of your sites, checks for the VerifiedDR badge embed, and updates its verification status. Identify it by slug or URL.

Same call in the CLIvdr sites:verify example.com

Request

curl https://verifieddr.com/api/v1/verify \
  -X POST \
  -H "Authorization: Bearer vdr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"example.com"}'

Response

{
  "slug": "example-com",
  "url": "https://example.com",
  "verified": true,
  "message": "Badge found, site verified."
}

Sites & monitoring

Sites

List your sites

Submit a site

Get one site

Get private TrueDR details

Monitoring and export

Monitor visibility changes

Export one site

Verification

Verify a badge

Build your next trusted connection