Documentation

Creating Your First Link

1. Log in to your Dashdig dashboard at dashdig.com
2. Paste any URL into the "Shorten URL" input field at the top of the dashboard
3. Click "Dig This!" — the AI will analyze the destination page and generate a human-readable slug
4. Review the suggested slug. You can accept it, click "Regenerate" for a new suggestion, or type your own custom slug
5. Click "Copy" to copy your new shortened URL. It's ready to share!

Authentication

All API requests require an API key in the header. Get your API key from Dashboard → Settings → API Keys. Keep your key secret — never expose it in client-side code.

Authorization: Bearer YOUR_API_KEY

Rate limits:

• Free: 100 requests/hour
• Starter: 200 requests/hour
• Pro: 500 requests/hour
• Developer: 500 requests/hour
• Business: 2,000 requests/hour

Create Short URL

POST /api/v1/links

Request body:

{
  "url": "https://example.com/very/long/path/to/page",
  "customSlug": "My.Custom.Slug",  // optional
  "password": "secret123",          // optional
  "expiresAt": "2026-12-31"         // optional
}

Response (201):

{
  "id": "abc123",
  "shortUrl": "https://dashdig.com/My.Custom.Slug",
  "originalUrl": "https://example.com/very/long/path/to/page",
  "slug": "My.Custom.Slug",
  "clicks": 0,
  "createdAt": "2026-02-22T00:00:00Z"
}

Errors:

• 400: { "error": "Invalid URL format" }
• 401: { "error": "Invalid API key" }
• 409: { "error": "Slug already taken" }
• 429: { "error": "Rate limit exceeded" }

Get URL Details

GET /api/v1/links/:id

Response (200):

{
  "id": "abc123",
  "shortUrl": "https://dashdig.com/My.Custom.Slug",
  "originalUrl": "https://example.com/...",
  "slug": "My.Custom.Slug",
  "clicks": 142,
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-02-22T14:00:00Z"
}

List URLs

GET /api/v1/links?page=1&limit=20

Query parameters: page (default: 1), limit (default: 20, max: 100), sort (default: "createdAt", options: "clicks", "updatedAt"), order (default: "desc", options: "asc")

Response (200):

{
  "links": [...],
  "total": 47,
  "page": 1,
  "pages": 3
}

Update URL

PUT /api/v1/links/:id

Request body (all fields optional):

{
  "customSlug": "New.Slug.Name",
  "password": "newpassword",
  "expiresAt": "2027-01-01"
}

Response (200): updated link object

Delete URL

DELETE /api/v1/links/:id

Response (200):

{ "message": "URL deleted successfully" }

Analytics

GET /api/v1/links/:id/stats

Query parameters: period (default: "7d", options: "24h", "7d", "30d", "90d")

Response (200):

{
  "totalClicks": 142,
  "clicksByDay": [
    {"date": "2026-02-20", "clicks": 34},
    {"date": "2026-02-21", "clicks": 28}
  ],
  "topReferrers": [
    {"source": "twitter.com", "clicks": 56},
    {"source": "linkedin.com", "clicks": 38}
  ],
  "topCountries": [
    {"country": "US", "clicks": 89},
    {"country": "UK", "clicks": 23}
  ],
  "devices": {
    "mobile": 67,
    "desktop": 71,
    "tablet": 4
  }
}

WordPress Plugin

Install from WordPress.org: search "Dashdig" in Plugins → Add New. Or download directly: wordpress.org/plugins/dashdig/

Setup:

1. Install and activate the plugin
2. Go to Settings → Dashdig
3. Enter your API key from your Dashdig dashboard
4. Choose auto-shorten settings

Features:

• Auto-shorten URLs in posts on publish
• Shortcode: [dashdig url="https://example.com/long-url"]
• Dashboard widget showing link stats

JavaScript Widget

Add to any website with one line:

<script src="https://cdn.dashdig.com/widget/v1/dashdig.min.js"
  data-api-key="YOUR_KEY" async></script>

Configuration options:

• position: "bottom-right" (default), "bottom-left", "top-right", "top-left"
• theme: "light" (default), "dark"

Browser Extension

Status: Chrome extension available.

Features:

• Right-click any link to shorten
• Popup showing recent URLs
• Keyboard shortcut support

npm Package

npm install dashdig

Usage:

const dashdig = require('dashdig');
dashdig.init('YOUR_API_KEY');

const link = await dashdig.shorten('https://example.com/long-url');
console.log(link.shortUrl);
// https://dashdig.com/Example.Page.Title