Skip to content

Dub.co

Link management and attribution platform for modern marketing teams.

Capabilities

IntegrationAvailableNotes
APIREST API for links, analytics, domains
MCP-Not available
CLI-Not available
SDKTypeScript SDK available

Authentication

  • Type: API Key
  • Header: Authorization: Bearer {api_key}
  • Get key: Settings > API Keys in Dub dashboard

Common Agent Operations

bash
POST https://api.dub.co/links

{
  "url": "https://example.com/landing-page",
  "domain": "link.example.com",
  "key": "summer-sale",
  "tags": ["campaign:summer", "channel:email"]
}
bash
GET https://api.dub.co/links?domain=link.example.com&key=summer-sale
bash
GET https://api.dub.co/links?domain=link.example.com&page=1
bash
GET https://api.dub.co/analytics?domain=link.example.com&key=summer-sale&interval=30d

Get clicks by location

bash
GET https://api.dub.co/analytics/country?domain=link.example.com&key=summer-sale

Get clicks by device

bash
GET https://api.dub.co/analytics/device?domain=link.example.com&key=summer-sale
bash
PATCH https://api.dub.co/links/{link_id}

{
  "url": "https://example.com/new-landing-page",
  "tags": ["campaign:summer", "channel:social"]
}
bash
DELETE https://api.dub.co/links/{link_id}
bash
POST https://api.dub.co/links/bulk

[
  {"url": "https://example.com/page1", "key": "page1"},
  {"url": "https://example.com/page2", "key": "page2"}
]

TypeScript SDK

Install

bash
npm install dub

Usage

typescript
import { Dub } from "dub";

const dub = new Dub({ token: "YOUR_API_KEY" });

// Create link
const link = await dub.links.create({
  url: "https://example.com",
  domain: "link.example.com"
});

// Get analytics
const analytics = await dub.analytics.retrieve({
  domain: "link.example.com",
  key: "summer-sale"
});

Key Features

  • Custom domains - Use your own branded domains
  • Link analytics - Clicks, locations, devices, referrers
  • Tags - Organize links by campaign, channel, etc.
  • QR codes - Auto-generated for each link
  • Password protection - Secure sensitive links
  • Expiration - Time-limited links
  • Geo-targeting - Redirect based on location

Analytics Dimensions

  • clicks - Total click count
  • country - Clicks by country
  • city - Clicks by city
  • device - Clicks by device type
  • browser - Clicks by browser
  • os - Clicks by operating system
  • referer - Clicks by referrer

When to Use

  • Creating trackable marketing links
  • Building referral link systems
  • Tracking campaign attribution
  • A/B testing landing pages via links
  • Generating branded short URLs
  • Analyzing link performance

Rate Limits

  • Free: 1,000 links, 5 API requests/second
  • Pro: Unlimited links, 50 API requests/second
  • Enterprise: Custom limits

Relevant Skills

  • referral-program
  • analytics-tracking
  • paid-ads

Released under the MIT License.