VerifiedDR API
Use VerifiedDR scores and actions in your app or agent. The API shares data and rules with the vdr CLI and MCP server.
- Base URL
https://verifieddr.com/api/v1- Authentication
Authorization: Bearer vdr_your_api_key- Limits
- 60 requests a minute
- Quota headers on every response
- JSON in, JSON out
Start in two minutes
One key, one header, one request. The first response is the JSON your app works with.
- 1
Create a key
Open API keys in the dashboard and create a key. It starts with vdr_. Keep it in server code and never in a browser.
- 2
Send your first request
Add the key as a bearer token. A site lookup returns DR, TrueDR, trust and traffic evidence for any approved website.
First requestcurl https://verifieddr.com/api/v1/lookup/verifieddr.com \ -H "Authorization: Bearer vdr_your_api_key" - 3
Or run the same call in the CLI
Every endpoint has a vdr command. Agents and scripts often prefer the shorter form.
Same operation in the CLIexport VERIFIEDDR_API_KEY=vdr_your_api_key vdr authority:lookup verifieddr.com
Authentication
Send the key as a bearer token with each request. Public lookups return public site data. Account routes return 404 for sites outside your account, so a leaked key never reveals which sites you own.
Authorization: Bearer vdr_your_api_keyRate limits and quota
Every authenticated call spends one quota unit, cached or not. The API comes with a 90-day growth program; the program sets the monthly meter.
| Account | Capacity |
|---|---|
| Verified free account | 25 lifetime calls, 5 requests a minute |
| Grow program | 5,000 calls a month, 60 requests a minute |
| Scale program | 10,000 calls a month, 60 requests a minute |
The free trial covers GET /lookup, /find, /map, /snippets, /categories and /account/usage, plus reading and editing AI Visibility questions on sites you own. Running a scan needs a running program. If onboarding granted the account a limited first scan, the API can use that allowance for up to 4 questions. Later scans and all other actions need a program.
Responses include X-API-Quota-Limit, X-API-Quota-Remaining, X-API-Quota-Period and X-API-Tier. A minute-rate limit returns 429 with Retry-After. A spent quota or a program gate returns 402 with an upgrade link. A program runs 90 days on one payment.
Choose a resource
Pick the job you want the API to do.
Visibility and discovery
Check any website, map its links and find trusted partners.
Sites and monitoring
Track your websites, export evidence and verify ownership.
Keywords
Read the DR a search term demands and track your targets.
Search and AI visibility
Read Search Console evidence and saved AI answer scans.
Reference
Errors, valid values and every CLI to HTTP pair.
Other ways in
Agents can use the same operations through MCP or the CLI without HTTP code.