Reference and CLI parity

Error contracts, the category values the API accepts, and the complete mapping from vdr commands to HTTP operations.

Create my API key Back to the overview

Errors

Every error is JSON with an error message. A gate adds the link that opens it.

400

Invalid input or an unsupported range.

401

Missing or invalid API key.

402

A growth program is required, or the lifetime or monthly quota is used up.

404

Unknown public site, or an owner-scoped site you do not own.

429

Per-key rate limit exceeded. Honor Retry-After.

503

Cached evidence or an upstream data source is temporarily unavailable.

Gated response

{
  "error": "This feature requires a paid plan.",
  "upgradeUrl": "https://verifieddr.com/pricing?...",
  "requiredPlan": "Pro",
  "blockedFeature": "keyword_research"
}

Complete CLI mapping

Every data command in the vdr CLI maps to the v1 API below. Hidden pre-0.2 aliases use the same operations.

vdr commands and the HTTP operations behind them
vdr command	HTTP operation
`authority:dr`	`GET /dr/:domain`
`authority:lookup`	`GET /lookup/:domain`
`map / authority:map`	`GET /map/:domain`
`discover:find`	`GET /find`
`exchanges`	`GET /lookup/:domain + GET /find?exchangesFor=…`
`exchanges --contact --approve`	`POST /find`
`badge:snippets`	`GET /snippets/:domain`
`categories:list`	`GET /categories`
`keywords:research`	`GET /keywords`
`keywords:suggest`	`GET /keywords/suggestions/:domain`
`keywords:tracked`	`GET/POST/DELETE /sites/:slug/keywords`
`sites:list / sites:submit`	`GET/POST /sites`
`sites:get`	`GET /sites/:slug`
`sites:truedr`	`GET /sites/:slug/truedr`
`sites:visibility`	`GET/POST/DELETE /sites/:slug/ai-visibility`
`sites:export`	`GET /export/:domain`
`sites:monitor`	`GET /monitor`
`sites:verify`	`POST /verify`
`sites:gsc-performance`	`GET /sites/:slug/gsc-performance`
`sites:gsc-audit`	`GET/POST /sites/:slug/gsc-audit`

CLI-only orchestration

Coach commands (analyze, diagnose, actions, audit backlinks, content-plan, fix, track, explain, boost and next) turn lookup and discovery JSON into local advice. They need no extra server endpoints. An exchange proposal is always previewed before it is approved.

sites:bing-setup only opens Bing Webmaster Tools, and sites:submit-urls talks to IndexNow with your hosted key. Neither spends a VerifiedDR API call. See the site endpoints for server-backed operations.

Reference and CLI parity

Errors

Categories

List category values

Complete CLI mapping

Build your next trusted connection