API Reference

Build powerful integrations with the Dr Urls REST API. Manage projects, trigger scans, and access SEO data programmatically.

Authentication

Secure API access with Bearer tokens

All API requests must include a valid API key in the Authorization header. You can generate API keys from your project settings in the dashboard.

Request Header

Authorization: Bearer YOUR_API_KEY

Base URL

All requests use HTTPS

https://drurls.com/api/v1

Endpoints

Available API endpoints

Method	Endpoint	Description
GET	`/projects`	List all projects
POST	`/projects`	Create a new project
GET	`/scans`	List scans for a project
POST	`/scans`	Start a new scan
GET	`/scans/:id`	Get scan details
GET	`/scans/:id/issues`	Get issues found in a scan
GET	`/scans/:id/pages`	Get crawled pages for a scan

Rate Limits

Fair usage limits for all plans

100

Requests per minute

429

Status code when exceeded

60s

Retry-After header value

Response Format

All responses are returned in JSON format with a consistent structure. Successful responses include a data field. Error responses include an error field with a message and code.

Success Response

{
  "data": {
    "id": "scan_abc123",
    "status": "completed",
    "pagesScanned": 142,
    "issuesFound": 23,
    "score": 87,
    "createdAt": "2026-03-15T10:30:00Z"
  },
  "meta": {
    "requestId": "req_xyz789"
  }
}

SDKs & Libraries

Node.js SDK

Coming soon

Official Node.js client for the Dr Urls API with TypeScript support.

npm install @drurls/sdk

Python SDK

Coming soon

Official Python client for the Dr Urls API with async support.

pip install drurls

Ready to integrate?

Generate your API key from the dashboard and start building.

Get your API key