Skip to main content

​
Links

Links are the core entity in Linquid. Each link represents a shortened URL that can redirect visitors to a destination. 
{
  "id": "link_abc123",
  "shortCode": "promo2024",
  "shortUrl": "https://linqu.id/promo2024",
  "destinationUrl": "https://example.com/landing",
  "title": "Black Friday Promo",
  "campaignId": "campaign_xyz",
  "enabled": true,
  "clicks": 1234,
  "uniqueClicks": 890,
  "conversions": 45,
  "createdAt": "2024-01-15T10:30:00Z"
}
PropertyTypeDescription
shortCodestringThe unique code in your short URL
destinationUrlstringWhere visitors are redirected
titlestringDisplay name for the link
descriptionstringOptional description
campaignIdstringParent campaign (required)
enabledbooleanWhether the link is active
expiresAttimestampAuto-disable after this time
clicksLimitnumberDisable after N clicks
passwordstringPassword protection

​
Redirect Behavior

Control how your link handles redirects:
ModeDescription
autoRedirect if destination exists
alwaysAlways redirect (error if no destination)
rule_onlyOnly redirect when a rule matches
neverTrack-only, return 204 No Content

​
Custom Domains

Links can use custom domains: 
https://go.yourcompany.com/promo2024
Set redirectDomain to use a system domain (linqu.id, linqid.io) or domainId to use your custom domain.

​
Deep Linking

Enable native app deep links: 
{
  "deepLinkEnabled": true,
  "deepLinkIos": "yourapp://path",
  "deepLinkAndroid": "intent://path#Intent;scheme=yourapp;end",
  "deepLinkFallbackUrl": "https://example.com/fallback"
}

​
Conversion Tracking

Track conversions by enabling conversionTracking: 
{
  "conversionTracking": true,
  "trackingType": "pixel"  // or "s2s"
}
When enabled, a click_id is appended to the destination URL for attribution.

​
Statistics

Links track:
  • clicks - Total click count
  • uniqueClicks - Unique visitors (fingerprint-based)
  • impressions - Page views (if enabled)
  • conversions - Attributed conversions
  • revenue - Total conversion revenue
  • lastClickedAt - Most recent click time